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译 者 序 


凡是 用 过 ASPNET MVC 的 开发 人 员 必 定 获 益 菲 浅 。ASPNET MVC 具有 耦合 性 低 、 
重用 性 高 、 生 命 周 期 成 本 低 、 部 署 快 、 可 维护 性 高 、 有 利于 软件 工程 化 管理 方面 的 优点 。 
该 架构 模式 对 于 大 中 型 应 用 程序 的 架构 和 开发 来 说 ， 优 势 尤为 明显 。 

一 直 以 来 ， 国 内 大 多 数 ASPNET 开 发 人 员 痢 限于 用 控件 拼装 Web 表 单 进行 Web 应 用 程 
序 的 开发 ， 这 使 得 不 少 开 发 人 员 更 关注 用 控件 实现 呈现 和 功能 交互 ， 而 往往 忽视 了 在 应 用 
程序 总 体 架 构 和 软件 层次 体系 方面 的 考虑 ， 也 相应 造成 了 Web 应 用 程序 展 著 个 齐 的 局 面 。 
随 着 ASPNET MVC 的 逐步 推广 应 用 ， 相 信 这 种 情况 会 有 所 改善 。 

本 书 对 ASPNET MVC 进行 了 全 面前 述 ， 读 者 通读 本 书后 ， 会 对 ASPNET MVC 有 更 
为 详尽 的 了 解 。 知 易 行 难 , 希望 有 志 于 从 事 Web 应 用 程序 开发 的 读者 能 够 从 本 书 中 获得 启 
发 并 党 试用 于 实践 ， 将 书本 内 容 转化 成 自己 的 知识 。 在 此 要 特别 强调 的 是 ， 本 书 第 II 部 分 
重点 介绍 了 移动 端 开发 方面 的 内 容 ， 也 算是 迎合 了 当前 的 时 代 潮 流 。 管 中 宁 豹 ， 我 们 由 此 
可 以 预见 ASPNET 整体 框架 将 僵 发 加 大 对 移动 端 开发 的 支持 , 而 ASPNET MVC 已 经 走 在 
了 了 前面, 所 以 ASPNET 开发 人 员 在 转 回 移动 端 开 发 的 同时 也 必然 盒 发 感受 到 微软 强大 的 文 
持 后 盾 。 

在 此 要 特别 感谢 清华 大 学 出 版 社 的 编辑 们 ， 他 们 在 本 书 翻译 过 程 中 为 译 者 提供 的 巨大 
帮助 ， 没 有 其 热情 付出 ， 本 书 将 难以 顺利 付 样 。 本 书 全 部 章节 由 潘 丽 蕊 翻 诺 ， 参 与 本 次 翻 
译 活 动 的 还 有 蒲 成 、 杨 轮 、 杨 达 辉 、 申 成 龙 、 杨 帆 、 赵 栋 、 王 滨 、 李 鹏 、 贫 书 谦 、 林 超 、 
陈 世 佳 。 在 此 一 并 表示 感谢 。 

译 者 具有 多 年 的 ASPNET 开发 经 验 ， 最 近 几 年 也 一 直 在 实际 开发 中 应 用 ASPNET 
MVC 的 先进 理念 和 技术 , 深 感 ASPNET MVC 作为 一 种 架构 模式 能 为 开发 人 员 带 来 极 大 的 
便捷 , 其 必 将 成 为 新 的 主流 开发 指导 思想 ,所 以 , 开发 人 员 都 应 该 尽早 掌握 ASPNET MVC， 
对 于 ASPNET 开发 人 员 来 说 尤其 如 此 。 由 于 译 者 水 平 有 限 , 难免 会 出 现 一 些 错误 或 翻译 不 
准确 的 地 方 ， 如 果 有 读者 能 够 指出 并 勤 正 ， 详 者 将 不 胜 感 激 。 


作者 商 介 


Dino Esposito 是 e-tennis.net 网 站 的 CTO 和 创始 人 之 一 ， 这 是 一 个 新 创办 的 为 专业 
网 球 和 运动 公司 提供 软件 和 IT 服务 的 网 站 。Dino 仍然 在 进行 大 量 的 培训 工作 和 写作 ， 
并 若 有 多 本 Web 开发 和 .NET 设计 方面 的 书籍 。 他 最 新 的 两 本 著作 是 由 微软 出 版 社 出 版 的 
Architecting Mobile Solutions for the Enterprise A Microsoft .NET: Architecting Applications for 
the Enterprise。Dino 经 第 在 行业 会 议 ( 包 括 DevConnections) 以 及 像 Software Architect、 
DevWeek 和 BASTA 这 样 的 欧洲 者 名 活动 中 演讲 。Dino 不 仅 是 JetBrains 公司 在 Android 
和 Kotlin 开发 方面 的 技术 专家 ， 还 是 提供 WUREFL 的 ScientiaMobile 数据 库 开发 团队 的 成 
员 。 访 数据 库存 储 了 大 量 移动 设备 性 能 ， 补 多 家 大 型 组 织 使 用 ， 比 如 Facebook。 

你 可 以 在 Twitter 上 通过 @despos 及 其 博客 (http://software2cents.wordpress.com) 来 天 

注 Dino。 


山 ， 
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首先 要 掌握 事实 ， 然 后 你 可 以 随意 焉 曲 它们 。 
Mark Twain 


ASPNET 诞生 于 20 世纪 90 年 代 末 期 各 行 各 业 正 迅速 探索 互联 网 的 时 代 。 ASPNET 的 
主要 目的 是 为 了 让 开发 人 员 能 够 快速 有 效 地 构建 应 用 程 订 ， 而 无 须 处 理 如 HTTP、 HTML 
和 JavaScript 等 错综复杂 的 底层 细节 。 这 正 是 当时 的 社会 环境 所 强烈 要 求 的 。ASPNET 是 
微软 推出 来 满足 这 项 需求 的 ， 且 大 大 超过 了 预期 的 程度 。 

十 多 年 后 的 今天 , ASPNET 的 发 展 显 得 有 些 滞 后 ,很 多 人 甚至 开始 质疑 Web 框架 存在 
的 必要 性 。 这 是 一 个 了 不 起 的 时 代 ， 为 我 们 提供 了 和 若干 选项 。 其 中 就 有 Web Forms 和 
ASPNET MVC 应 用 程序 ， 还 有 更 多 JavaScript 密集 型 客户 端 应 用 程序 ( 单 页 面 应 用 程序 )， 
它们 使 用 一 个 服务 器 端 后 台 来 为 实际 公开 的 一 些 页 面 提供 基本 布局 和 特 设 服 务 , 比如 捆绑 。 

奇妙 的 是 , 使 用 Web Forms 模式 , 你 仍 可 以 编写 功能 性 应 用 程序 , 尽管 ASPNET MVC 
能 够 更 密切 地 服务 于 开发 人 员 的 当前 需求 。Web Forms 的 最 常见 应 用 场景 是 ， 你 要 开发 专 
注 于 呈现 数据 并 使 用 优质 第 三 方 控 件 套装 的 应 用 程序 。ASPNET MVC 可 用 于 处 理 其 他 所 
有 方面 ， 包 括 客 户 端 单 页 面 应 用 程序 的 框架 搭建 。 

Web 应 用 程序 的 改变 方式 证 明了 ，ASPNET MVC 可 能 未 能 替代 ASPNET Web Forms 
在 众多 开发 人 员 心 目 中 的 地 位 ， 但 这 却 是 正确 的 选择 ，ASPNET MVC 足以 成 为 任何 一 个 
需要 实体 后 台 的 应 用 程序 的 理想 Web 平台 ， 对 于 那些 以 多 设备 实用 功能 为 目标 的 Web 应 
用 程序 来 说 尤其 如 此 。 是 的 ， 这 很 可 能 意味 着 个 到 两 年 时 间 内 的 所 有 Web 应 用 程序 。 

转换 到 ASPNET MVC， 对 于 ASPNET 开发 人 员 来 说 是 相当 自然 的 过 程 。 


本 书 读者 对 象 


这 几 年 来 , 不 少 人 读 过 我 的 一 些 书 籍 和 文章 。 这 些 读者 已 经 察觉 到 了 , 我 并 不 擅长 写 
作 步 又 详解 类 的 参考 型 书籍 ， 同 样 ， 我 也 不 能 对 同一 门 课程 在 前 后 两 次 的 教学 中 以 相同 的 
顺序 介绍 主题 ， 或 提供 前 后 相同 的 例子 。 
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此 书 并 不 适合 绝对 的 初学 者 ; 但 除 此 之 外 的 其 他 人 我 觉得 都 可 以 阅读 ， 包 括 那 些 对 
ASPNET MVC 还 不 其 了 解 的 人 。 能 力 和 专业 水 平 越 高 的 人 ， 越 难 在 本 书 中 找到 相关 专业 
领域 的 附加 值 。 然 而 ， 这 本 书 得 益 于 几 年 的 现实 实践 ， 我 相信 其 中 一 定 有 很 多 可 能 还 会 吸 
引 专 家 的 解决 方案 ， 尤 其 是 涉及 移动 设备 方面 的 。 

如 果 你 使 用 ASPNET MVC， 我 相信 你 一 定 会 在 此 书 中 找到 一 些 有 价值 的 东西 。 


假定 

这 本 书 假 定 你 对 ASPNET 开发 有 基本 的 了 解 。 
个 适合 阅读 本 书 的 人 群 

如 果 你 需要 的 是 ASPNET MVC 分 步 指南 ， 那 么 本 书 算 不 上 是 一 本 理想 的 书籍 。 


本 书 结构 


该 书 分 为 三 个 部 分 。 第 I 部 分 :“ASPNET MVC 基础 ”% 提供 了 对 ASPNET 基础 和 其 
核心 组 件 的 简短 概述 。 第 [部 分 :“ASPNET MVC 软件 设计 ?， 着 重 介 绍 Web 应 用 程序 、 
特定 设计 模式 和 最 佳 实 践 的 第 见 问题 。 最 后 ， 第 II 部 分 :“ 移 动 客 户 端 ” 是 有 关 JavaScript 
和 移动 寞 面 的 。 


系统 要 求 


需要 安 站 以 下 软件 以 运行 本 书 中 所 提供 的 示例 : 

e 以 下 的 操作 系统 之 一 :Windows 8/8.1、Windows 7、Windows Vista with Service Pack 2 (| 际 
了 了 了 商 化 版 )、Windows XP with Service Pack 3( 除 了 侧 化 碑 )、Windows Server 2008 with 
Service Pack 2、Windows Server 2003 with Service Pack 2 以 及 Windows Server 2003 R2。 

e Microsoft Visual Studio 2013 的 任意 版 本 (如 末 你 使 用 Express Edition 产品 ， 则 可 能 再 要 
多 个 下 载 )。 


e Microsoft SQL Server 2012 Express Edition 或 更 高 版 本 ， 以 及 SQL Server Management 
Studio 2012 Express 或 更 高 版 本 (与 Visual Studio 一 起 分 发 ， Express Edition 需要 单独 
下 载 )。 
根据 你 的 Windows 配置 ， 可 能 需要 本 地 管理 员 权 限 才能 安装 或 配置 Visual Studio 2013 
和 SQL Server 2012 产品 。 


示例 代码 下 载 


该 书 的 大 多 数 蕙 都 包含 一 些 练 习 ， 你 可 以 用 交互 的 方式 符 试 正文 中 所 学 到 的 新 材 
料 。 可 以 从 以 下 网 页 下 载 所 有 的 示例 项 目 ， 包 括 它 们 实践 前 和 实践 后 的 格式 : 


httPp:/ /aka-ms/PIogramaSP-NET MVC/files 
http://www.tupwk.com.cn/downpage 


请 按照 说 明 下 载 asp-net-mvc-examples.zip 文件 。 


安 汉代 码 示例 


通过 执行 下 列 步骤 ， 在 你 的 计算 机 中 安装 代码 示例 ， 以 便 在 你 做 本 书 中 的 练习 时 可 以 
使 用 。 

(1) 将 对 本 书 的 网 站 上 下 载 的 asp-net-mvc-examples.zip 文件 进行 解压 (如 有 必要 ， 指 定 
一 个 特定 的 目录 和 路 径 来 创建 它 )。 

(2) 如 果 弹 出 提示 ， 请 查看 所 显示 的 最 终 用 户 许 可 协议 。 如 果 你 接受 这 些 条 球 ， 请 选 
择 Accept 选项 ， 然 后 单 击 Next。 


注意 : 

如 果 没 有 显示 许可 协议 ， 你 可 以 从 下 载 asp-net-mvc-examples.zip 文件 的 网 页 访问 它 。 
使 用 示例 代码 

Setup.exe 程序 所 创建 的 文件 夹 包含 每 一 章 的 一 个 子 文件 夹 。 反之 , 每 一 章 可 能 包含 额 
外 的 子 文件 来 。 所 有 示例 都 被 组 织 在 一 个 单独 的 Visual Studio 2013 解决 方案 中 。 你 要 打开 
Visual Studio 2013 中 的 解决 方案 文件 并 寻 航 到 这 些 示 例 。 
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勘误 及 相关 支持 

我 们 尽 一 切 努 力 确保 此 书 及 其 同步 内 容 的 准确 性 。 本 书 自 出 版 以 来 所 报告 的 一 切 错误 
部 列 在 微软 出 版 社 网 站 上 : 

http://aka.ms/programASP-NET MVC/errata 


如 果 你 发 现 了 未 列 出 的 错误 ， 可 以 通过 相同 的 页 面 发 送 报告 给 我 们 。 

如 果 你 需要 额外 的 支持 ， 请 发 送 电 子 邮 件 到 mspinput@microsoft.com 给 微软 出 版 社 的 
文 持 部 。 

请 注意 ， 上 述 地 址 不 提供 敏 软 软件 的 产品 文 持 。 


我 们 期 竺 你 的 反馈 


在 微软 出 版 社 ， 你 的 满意 才 是 我 们 的 首要 任务 ， 你 的 反馈 是 我 们 最 宝贵 的 财富 。 请 告 
诉 我 们 你 对 此 书 的 看 法 : 


http://aka.ms/tellpress 


这 项 调查 是 短暂 的 ， 但 我 们 认真 阅读 你 的 每 一 条 意见 和 想法 。 提 前 感谢 你 的 输入 ! 


你 持 联 系 


让 我 们 将 交流 继续 下 去 ! 这 里 是 我 们 的 Twitter 网 址 : http://twitter.com/MicrosoftPress。 
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ASP.NET MVC 控制 硕 


人 们 总 说 时 间 会 改变 一 切 ， 但 实际 上 你 必须 自己 动手 去 改变 一 切 。 


Andy Warhol 


我 认为 从 Ajax 征服 大 众 的 那 一 天 开始 , ASPNET Web Forms 就 开始 变 得 不 堪 胜 任 了 。 正 
如 有 些 人 所 说 ，Ajax 已 经 成 为 一 只 射 中 ASPNET 之 路 的 男 一 支 Achilles 毒 箭 了 了。Ajax 使 得 
对 HIML 和 客户 端 代码 拥有 越 来 越 多 的 控制 权 这 一 情形 成 为 了 事实 存在 。 随 独 时 间 的 推移 ， 
这 引发 了 不 同 架 构 的 形成 ， 使 ASPNET Web Forms 逐渐 丧失 了 对 任务 的 胜任 能 力 。 

由 于 可 以 适用 于 现 有 的 ASPNET 运行 时 ，MVC 模式 产生 了 一 个 新 的 框架 
MVC 一 一 它 能 让 Web 开发 与 开发 人 员 的 当前 需求 相 匹 配 。 

在 ASPNET MVC 中 ， 每 个 请 求 的 结果 最 终 都 会 执行 某 个 操作 一 一 根本 上 来 说 也 就 是 特 
定 类 上 的 方法 。 操 作 执 行 的 结果 会 与 一 个 视图 模板 一 起 传递 给 视图 子 系统 。 结 果 和 模板 随后 
会 用 于 生成 浏览 器 的 最 终 啊 应 。 用 户 不 需要 将 浏览 右 指 同 某 个 页 面 ， 他 们 只 需要 放置 一 个 请 
求 即 可 。 难 道 这 还 不 是 很 大 的 变化 吗 ? 

与 Web Forms 不 同 ，ASPNET MVC 是 由 连接 在 一 起 的 各 种 代码 层 所 组 成 ， 而 不 是 交织 
在 一 起 形成 一 个 单一 的 整体 块 。 鉴 于 此 ， 可 以 很 容易 地 以 自 定 义 组 件 普 换 任何 层 ， 用 以 提高 
解决 方案 的 可 维护 性 和 可 测试 性 。 使 用 ASPNET MVC， 可 以 获得 对 标记 的 完全 控制 ， 并 能 
随意 用 你 最 喜欢 的 JavaScript 框架 来 套用 样式 和 注入 脚本 代码 。 

基于 与 Web Forms 相同 的 运行 时 环境 , ASPNET MVC 推出 了 一 个 适合 于 Web 应 用 程序 
的 经 典 模型 -视图 -控制 右 (Model-View-Controller) 模 式 , 使 Web 应 用 程序 的 开发 有 了 明显 个 同 的 
体验 。 在 这 一 章 中 ,你 将 会 了 解 控 制 器 的 结构 与 作用 一 一 ASPNET MVC 应 用 程序 的 基础 一 一 
以 及 请 求 被 路 由 到 控制 器 的 方式 。 

尽管 你 有 可 能 决定 继续 使 用 Web Forms 来 进行 当前 的 Web 开发 ,但 ASPNET MVC 的 确 
是 更 好 的 选择 。 虽 然 不 需要 投入 大 量 的 时 间 ， 但 你 需要 确切 地 知道 发 生 了 什么 以 及 MVC 背 
后 的 原理 。 如 果 照 此 做 ， 那 么 你 的 任何 投入 都 将 会 比 预 期 更 早 地 得 到 回报 。 
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注意 : 

本 书 基 于 ASPNETMVC 5。 此 版 本 的 ASPNET MVC 妆容 之 前 的 版 本 。 这 意味 着 可 以 在 
同一 台 计 算 机 上 同时 安 角 两 个 版 本 ， 在 使 用 最 新 版 本 时 不 会 影响 你 已 经 拥有 的 现成 的 MVC 
代码 ， 


1.1 对 输入 请 求 进 行路 由 


最 初 , 整个 ASPNET 平台 都 是 围绕 着 服务 物理 页 面 请 求 的 理念 来 开发 的 。 事 实证 明 大 部 
分 在 ASPNET 应 用 程序 中 所 使 用 的 URL 都 由 两 部 分 组 成 : 分 别 是 包含 了 逻辑 的 物理 网 页 路 
径 ， 和 填充 在 查询 字符 串 中 用 于 提供 参数 的 一 些 数 据 。 这 种 方法 已 经 使 用 数 年 ， 现 今 仍然 有 
效 。 然 而 ，ASP.NET 运行 时 环境 并 不 会 限制 你 仅仅 调用 由 特定 位 置 和 文件 所 确定 的 资源 。 通 
过 编写 一 个 专门 的 HTTP 处 理 程序 并 将 其 绑 定 到 一 个 URL， 就 可 以 使 用 ASPNET 来 执行 代 
码 以 啊 应 请 求 ， 而 无 须 依 赖 物理 文件 。 这 只 是 ASPNET MVC 与 ASPNET Web Forms 之 间 的 
一 个 主要 区 别 。 让 我 们 大 致 了 解 一 下 如 何 用 HITP 处 理 程序 来 模拟 ASPNET MVC 行为 。 


注意 : 

在 软件 中 , 术语 URI( 统 一 资源 标识 符 ) 是 指 通 过 一 个 位 置 或 一 个 名 称 来 引用 资源 。 当 URI 
通过 位 置 识别 资源 时 ， 它 被 称 作 URL 或 统一 资源 定位 符 。 当 URI 通过 名 称 识别 资源 时 ， 它 
就 成 为 一 个 URN 或 统一 资源 名 称 。 在 这 方面 ，ASPNET MVC 旨 在 处 理 更 通用 的 URI， 而 
ASPNET Web Forms 主要 处 理 位 置 感知 的 物理 资源 。 


1.1.1 模拟 ASPNET MVC 运行 时 


让 我 们 构建 一 个 简单 的 ASPNET Web Forms 应 用 程序 ， 并 使 用 HTTP 处 理 程 序 来 理解 
ASPNET MVC 应 用 程序 的 内 部 机 制 。 可 以 先 从 微软 Visual Studio 项 目 管 理 堪 处 获取 基本 的 
ASPNET Web Forms 应 用 程序 。 


1. 定义 可 识别 的 URL 的 语法 


由 于 请 求 的 URL 不 一 定 与 Web 服务 右上 的 物理 文件 相 匹 配 ， 因 此 第 一 步 即 是 列 出 哪些 
URL 对 应 用 程序 有 意义 。 为 了 避免 过 于 特殊 ， 我 们 假设 你 只 文 持 几 个 固定 的 URL， 每 一 个 都 
会 映射 到 一 个 HITP 处 理 程序 组 件 。 下 和 面 的 代码 片段 显示 了 需要 对 默认 web.config 文件 所 做 
的 更 改 : 

<httpHandlers> 


<add verb="*™ 
path="home/test/*" 
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type="MvcEmule.Components.MvcEmuleHandler™ /> 
</httpHandlers> 


每 当 应 用 程序 收 到 与 指定 URL 匹配 的 请 求 时 ， 它 就 会 将 其 传递 到 指定 的 处 理 程序 。 

2. 定义 HTTP 处 理 程序 的 行为 

在 ASPNET 中 ，HTTP 处 理 程序 是 一 个 实现 了 IHttpHandler 接口 的 组 件 。 该 接口 比较 简 
单 ， 包 括 以 下 两 个 部 分 : 


public class MvcEmuleHandler : IHttpHandler 


{ 
public voild ProcessRequest (HttpContext context) 


{ 


// Logic goes here 


} 


public Boolean IsReusable 


{ 
get { return false; } 


} 
} 


大 部 分 情况 下 ，HTTP 处 理 程序 都 有 一 个 只 受 条 些 通 过 会 询 子 符 串 传递 的 输入 数据 所 影 
吧 的 便 编 码 行 为 。 不 过 ， 我 们 也 可 以 量 不 费力 地 将 处 理 程序 用 作 抽 象 工厂 来 再 增加 一 级 间接 
层 。 事 实 上 , 处 理 程序 可 以 使 用 来 自 请 求 的 信息 以 确定 要 调用 的 外 部 组 件 以 切实 地 处 理 请 求 。 
这 样 一 来 ， 单 个 HTTP 处 理 程 序 就 可 以 服务 各 种 请 求 ， 并 且 只 需要 在 一 些 专门 的 组 件 之 间 分 
配 调用 。 

HTTP 处 理 程 序 可 以 解析 出 令 牌 中 的 URL， 并 使 用 该 信息 来 标识 要 调用 的 类 和 方法 。 这 
里 是 一 个 显示 其 工作 原理 的 示例 : 


public void ProcessRequest (HttpContext context) 
{ 
// Parse out the URL and extract controller, action, and parameter 
Var segments = context.Request .Url.Segments; 
var controller = segments[1] .TrimEnd('/"'); 
Var action = segments{[2] .TrimEnd('/"'); 
Var paraml] = segments[3] .TrimEnd('/"'); 


// Complete controller class name with suffix and (default) namespace 
var fullName = String.Format ("{0}.{1}Controller™, 
this.GetType() .Namespace, controller); 
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} 


Var controllerType = Type.GetType (fullName, true, true}); 


// Get an instance of the controller 
Var instance = Activator.CreateInstance (controllerType); 


// Invoke the action method on the controller instance 
Var methodInfo = controllerType.GetMethod (action, 
BindingFlags.Instance | 
BindingFlags.lIgnoreCase | 
BindingFlags.Public); 
var result = string.Empty; 


if (methodIinfo.GetParameters() .Lengthn == 0) 
{ 
result = methodInfo.Invoke (instance, null) as String; 
f 
else 
{ 
result =methodInfo.Invoke (instance, new Object[] { paraml }) as String; 
} 


// Write out results 
context .Response.Write (result); 


前 面 的 代码 假定 , 该 URL 中 服务 器 名 称 后 面 的 第 一 个 令 牌 包 合 一 些 关 键 信息 , 用 来 标识 
即将 用 于 处 理 请 求 的 专门 组 件 。 第 二 个 令 牌 引用 了 调用 该 组 件 的 方法 名 称 。 最 后 ， 第 三 个 令 


3. 调用 HTTP 处 理 程序 


给 定 一 个 URL， 比 如 hometest*， 不 论 后 面 的 参数 是 什么 ，home 都 用 于 标识 类 ，test 
用 于 标识 方法 。 该 类 的 名 称 会 进一步 指定 并 扩展 以 包含 一 个 名 称 空间 和 一 个 后 缀 。 在 本 例 中 ， 
取 终 的 类 名 是 MvcEmule.Components.HomeController。 该 类 可 用 于 应 用 程序 。 也 可 公开 成 一 
个 称 为 Test 的 方法 ， 如 下 所 示 : 


namespace MvcEmule.Components 


{ 


public class HomeController 
{ 
public String Test (Object Paraml ) 
{ 
var message = "<html><hl>Got it! You passed {0}'</hl></ntml>"; 
return String.Format (message, param]); 
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} 
} 

} 

1-1 显示 了 在 ASPNET Web Forms 应 用 程序 中 调用 某 个 页 面 不 可 知 URL 的 效果 。 


[= 
< 怕 http://localhost1]340/horme/test/65 


(sot it! You passed 0、 


图 1-1 在 ASPNET Web Forms 中 处 理 某 个 页 面 不 可 知 的 URL 


这 个 简单 的 示例 揭示 了 ASPNET MVC 所 使 用 的 基本 机 制 。 处 理 请 求 的 专门 组 件 是 控制 
器 。 控 制 器 是 一 个 只 有 方法 而 无 状态 的 类 。 独 特 的 系统 级 HTTP 处 理 程序 负责 将 传 入 的 请 求 
分 派 到 一 个 专门 的 控制 器 类 ， 这 样 该 类 的 实例 就 会 执行 给 定 的 操作 方法 并 产生 啊 应 。 

那么 URL 的 架构 是 什么 呢 ? 在 本 示例 中 ， 仅 仅 使 用 了 硬 编 码 的 UREL。 而 在 ASPNET 
MVC 中 ， 可 以 使 用 非常 灵活 的 语法 来 表示 应 用 程序 可 识别 的 URL。 此 外 ， 运 行 时 管道 中 的 
一 个 新 系统 组 件 会 截取 请 求 ， 处 理 该 URL， 并 触发 ASPNET MVC HTTP 处 理 程 序 。 该 组 件 
就 是 URL 路 由 HTTP 模块 。 
1.1.2 ”URL 路 由 HTTP 模块 

URL 路 由 HTTP 模块 通过 查看 URL 并 把 它们 分 派 到 最 适当 的 执行 器 来 处 理 传 入 的 请 求 。 
URL 路 由 HTTP 模块 取代 了 旧版 本 ASPNET 的 URL 重 写 功能 。 在 其 核心 处 ，URL 重 写 由 挂 
接 请 求 、 解析 原始 URL 和 指示 HITP 运行 时 环境 组 成 , 用 以 处 理 “ 可 能 相关 却 不 同 ” 的 URL。 

1. 取代 URL 重 写 

如 果 需 要 在 可 读 的 、 搜 索引 擎 优化 (SEO) 友 好 的 URL 和 以 编程 方式 处 理 大 量 的 URL 之 
间 进 行 权 衡 ， 那 么 URL 重 写 就 可 以 发 挥 重要 作用 。 比 如 ， 请 思考 下 面 的 URL: 

http://northwind.com/news .aspx?1d=1234 

news.aspx 页 面包 含 了 检索 、 格 式 化 和 显示 任意 给 定 新 闻 所 需 的 逻辑 。 检索 特定 新 闻 的 ID 
是 通过 查询 字符 串 上 的 参数 提供 的 。 作 为 开发 人 员 ， 执 行 该 页 面 再 简单 不 过 ; 获取 查询 字符 
串 参 数 、 运 行 查询 并 创建 HIML。 而 作为 用 户 或 对 于 搜索 引擎 来 说 ， 仅 仅 通过 简单 地 查看 访 
URL 并 不 能 真正 理解 该 页 面 的 意图 ， 你 不 大 可 能 轻松 记 住 这 个 地 址 并 分 发 出 去 。 
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URL 重 写 会 在 两 个 方面 对 你 有 所 助 荔 。 首 先 ， 它 使 开 有 人员 可 使 用 一 个 通用 的 前 端 页 面 
(如 news.aspx) 来 显示 相关 内 容 。 第 二 ， 它 使 用 户 请 求 友 好 的 URL 成 为 可 能 ， 该 URL 以 编程 
方式 映射 到 不 太 直 观 但 容易 管理 的 URL。 总 之 , URL 重 写 确实 可 以 将 处 理 该 请 求 的 物理 网 页 
与 所 需 的 URL 进行 解 耦 。 

在 最 新 版 本 的 ASPNET 4 Web Forms 中 , 可 以 使 用 URL 路 由 将 传 入 的 URL 与 其 他 URL 
进行 匹配 而 不 用 付出 HITP 302 重 定 同 的 人 代价。 相反， 在 ASPNET MVC 中 ，URL 路 由 提供 
了 把 传 入 的 URL 映射 到 控制 器 类 和 操作 方法 的 服务 。 


注意 : 

URL 路 由 模块 最 初 是 作为 ASPNET MVC 组 件 来 开发 的 ， 而 现在 成 为 ASPNET 平台 的 
一 个 原生 部 分 ， 且 如 前 所 述 ， 它 能 够 同时 为 ASPNET MVC 和 ASPNET Web Forms 应 用 程序 
提供 服务 ， 虽 然 是 通过 略微 不 同 的 API. 


2. 对 请 求 进 行路 由 


当 一 个 请 求 在 互联 网 信息 服务 (Internet Information Services，IIS) 入 口 等 待 处 理 时 ， 究 竟 
会 发 生 什 么 ? 图 1-2 为 你 提供 了 一 个 所 涉及 的 各 个 步骤 的 人 全貌， 以 及 ASPNET MVC 和 
ASPNET Web Forms 应 用 程序 中 的 不 同 工 作 机 制 。 

URL 路 由 模块 能 够 为 应 用 程序 截取 只 能 由 IIS 服务 的 请 求 。 如 果 URL 引用 了 物理 文件 
(比如 ASPX 文件 )， 路 由 模块 就 会 忽略 该 请 求 ， 除 非 它 是 以 其 他 方式 配置 的 。 随 后 该 请 求 会 
进入 经 典 的 ASPNET 机 制 ， 利 用 页 面 处 理 程序 像 寻 常 方式 一 样 进 行 处 理 。 

否则 ，URL 路 由 模块 会 尝试 把 请 求 的 URL 匹配 到 应 用 程序 定义 的 任意 路 由 。 如 果 找 到 
匹配 项 ， 请 求 将 转 到 ASPNET MVC 空间 按照 控制 器 类 的 调用 进行 处 理 。 如 果 没 有 找到 匹配 
项 , 请 求 将 会 由 标准 的 ASPNET 运行 时 以 最 佳 方式 来 提供 服务 , 并 很 可 能 引发 一 个 HTTP 404 

最 后 ， 只 有 与 预定 义 URL 模式 (也 称 为 路 由 ) 相 [匹配 的 请 求 才 能 享有 ASPNET MVC 运行 
时 。 所 有 这 类 请 求 会 被 路 由 到 一 个 共同 的 HITP 处 理 程序 ， 该 处 理 程序 将 控制 器 类 实例 化 并 
调用 该 类 中 一 个 定义 了 的 方法 。 接 下 来 ， 控 制 器 方法 会 进而 选择 视图 组 件 生成 实际 的 啊 应 。 


3. URL 路 由 模块 的 内 部 结构 


在 执行 方面 , 需要 指出 的 是 ，URL 路 由 引擎 是 一 个 把 PostResolveRequestCache 事件 串联 
起 来 的 HTTP 模块 。 在 检查 出 请 求 的 啊 应 不 在 ASPNET 缓存 中 以 后 ， 就 会 触发 该 事件 。 
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Web Forms IS 上 的 ASPNET HTTP 运行 时 


一 一 aspx 页 面 1 J 


aspx 页 面 2 .里 ___-_. 


一 一 ”调用 者 /ALPCI 一 > 


po 命令 /更 新 /123 一 一 


ASPNET IIS 上 的 ASPNET HTTP 运行 时 
MVC 


图 1-2 ASPNET MVC 中 路 由 模块 的 角色 


HTTP 模块 将 所 请 求 的 URL 匹配 到 一 个 用 户 定 义 的 URL 路 由 ， 并 将 HITP 上 下 文 设置 
为 使 用 ASPNET MVC 标准 的 HTTP 处 理 程 序 来 处 理 该 请 求 。 作 为 开发 人 员 ， 你 不 可 能 直接 
人 处理 URL 路 由 模块 。 该 模块 是 由 系统 提供 的 ， 你 不 需要 制定 任何 具体 的 配置 格式 。 相反 ， 你 
要 负责 提供 应 用 程序 支持 有 旦 模块 会 实际 使 用 的 路 由 。 

1.1.3 ”应 用 程序 路 由 

按照 设计 ，ASPNET MVC 应 用 程序 不 再 强制 需要 依赖 物理 页 面 。 在 ASPNET MVC 中 ， 
用 户 要 放置 作用 于 资源 的 请 求 。 然 而, 框架 不 会 强行 规定 资源 和 操作 的 描述 语法 。“ 作 用 于 资 
源 ” 这 个 表述 可 能 会 让 你 想到 有 具象 状态 传输 (Representational State Transfer，REST)。 当然， 
你 这 样 想 也 并 不 离谱 。 

虽然 你 确实 可 在 ASPNET MVC 应 用 程序 中 使 用 纯粹 的 REST 方 法 ,但 我 于 愿 说 ASPNET 
MVC 是 松散 地 面 同 REST 的 , 它 确实 认可 诸如 资源 和 操作 的 概念 , 但 它 可 以 让 你 自由 使 用 自 
己 的 语法 来 表达 和 执行 资源 及 操作 。 举 例 来 说 ， 在 一 个 纯粹 的 REST 解决 方案 中 ， 你 会 利用 
HTTP 动词 来 表示 操作 一 一 GET、POST、PUT 和 DELETE 一 和 URI 以 标识 资源 .在 ASPNET 
MVC 中 实现 一 个 纯粹 的 REST 解决 方案 是 可 能 的 ， 但 你 需要 做 一 些 额 外 工作 。 

ASPNET MVC 中 的 默认 行为 是 使 用 你 自己 的 语法 所 编写 的 自 定 义 URL， 通 过 这 些 语法 
来 指定 资源 和 操作 。 该 语法 通过 URL 模式 集合 来 表达 ， 也 称 为 路 由 。 
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1. URL 模式 和 路 由 
路 由 是 代表 URL 绝对 路 径 的 模式 匹配 字符 串 , 即 没有 协议 、 服 务 器 和 端口 信息 的 URL 


字符 串 。 路 由 可 以 是 一 个 常量 字符 串 ， 但 更 有 可 能 包含 一 些 占 位 符 。 下 面 是 一 个 示例 路 由 


/home/test 


该 路 由 是 一 个 常量 字符 串 ， 并 只 由 绝对 路 征 是 /home/test 的 URL 匹配 。 然 而 大 多 数 时 候 ， 


你 会 处 理 包含 一 个 或 多 个 占 位 符 的 参数 化 路 径 。 下 面 是 两 个 示例 : 


/{resourcel}/{action]} 
/Customer/ {action} 


这 两 个 路 由 都 是 由 确切 包含 两 个 部 分 的 任意 URL 所 匹配 。 但 后 者 要 求 第 一 个 部 分 等 于 


字符 串 “Customer”。 而 前 者 并 不 对 该 部 分 内 容 作 具体 限制 。 
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占 位 符 通 贡 裤 称 为 URL 参数 ， 是 括 在 大 插 写 个 中 的 名 称 。 一 个 路 由 可 以 有 多 个 占 位 香 ， 


只 要 将 它们 用 币 量 或 分 隅 符 分 隅 开 来 。 正 斜 杠 (0) 字 符 用 作 路 由 各 部 分 之 间 的 分 隔 符 。 占 位 符 
的 名 称 (比如 action) 是 代码 以 编程 方式 从 实际 URL 处 检索 相应 内 容 的 关键 所 在 。 


下 面 是 一 个 ASPNET MVC 应 用 程序 的 默认 路 由 : 

{controller}/{action}/{1d} 

该 示例 路 由 包含 了 由 分 隔 符 分 开 的 三 个 占 位 符 。 下 面 的 这 个 URL 可 匹配 这 个 路 由 : 
/Customers/Edit/ALFKI 

可 以 任意 添加 多 个 路 由 ， 以 及 你 认为 合适 的 多 个 占 位 符 。 甚 至 还 可 以 删除 默认 的 路 由 。 
2. 定义 应 用 程序 路 由 

应 用 程序 路 由 通常 在 global.asax 文件 中 注册 ， 并 在 应 用 程序 启动 时 得 到 处 理 。 让 我 们 看 


看 globalasax 文件 中 处 理 路 由 的 这 一 部 分 : 


Public class MvcApplication : HttpApplication 


{ 
protected vold Application Start () 
{ 
RouteConfig.ReglisterRoutes (RouteTable.Routes) ; 
// Other code 
} 
} 
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RegisterRoutes 是 一 个 在 通 贡 命名 为 App_:Start( 但 可 以 随意 重 命 名 该 文件 夹 ) 的 单独 文件 
夹 中 所 定义 的 RouteConfig 类 的 方法 。 下 面 是 该 类 的 实现 : 


public class RoutecConft1d 


{ 
public static void RegisterRoutes (RouteCollection routes) 
{ 
// Other code 
// Listing routes 
routes .MapRoute ( 
"Default™, 
"Icontroller}/{action}/{1iqd}"™, 
mew { 
controller = "Home™, 
action = "Index™, 
1d = UrlParameter.Optional 
}); 
} 
} 


如 你 所 见 , Application Start 事件 处 理 程序 调用 一 个 名 为 RegisterRoutes 的 公共 静态 方法 ， 
其 中 列 出 了 所 有 路 由 。 注 意 RegisterRoutes 方法 的 名 称 及 原型 是 随意 的 ， 可 以 根据 实际 情况 
下 

所 文 持 的 路 由 必须 添加 到 由 ASPNET MVC 管理 的 路 由 对 象 的 静态 集合 中 。 该 集合 就 是 
RouteTable.Routes。 通 各 使 用 便捷 的 MapRoute 方法 来 填充 该 集合 。MapRonute 方法 提供 了 各 
种 重 载 且 在 大 部 分 时 间 都 能 够 很 好 地 执行 。 但 是 它 不 可 能 让 你 对 路 由 对 象 的 每 个 可 能 方面 都 
进行 配置 。 如 果 需 要 在 路 由 上 做 一 些 MapRoute 并 不 支持 的 设置 ， 则 可 能 需要 借助 于 下 面 的 

// Create a new route and add it to the System collection 


Var route = new Routel(...}); 
RouteTable.Routes.Add ("NameOofTheRoute™", route); 


路 由 是 通过 一 些 特 性 来 加 以 描述 的 ， 如 名 称 、URL 模式 、 默 认 值 、 限 制 条 件 、 数 据 令 牌 
和 路 由 处 理 程序 。 而 最 第 用 到 的 特性 设置 包括 名 称 、URL 模式 和 默认 值 。 让 我 们 在 你 获取 的 
默认 路 由 的 代码 上 进行 扩展 : 

routes .MapRoute ( 


"Default", 
“"{controllerl} / {act1ion} / { i1d]} m 
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mew 1{ 
controller = "Home™, 
action = "Index™, 
1d = UrlParameter.Optional 
}); 
第 一 个 参数 是 路 由 的 名 称 ; 每 个 路 由 都 有 一 个 唯一 的 名 称 。 第 二 个 参数 是 URL 模式 。 
第 三 个 参数 是 一 个 指定 URL 参数 默认 值 的 对 象 。 
注意 URL 甚至 可 以 匹配 不 完整 形式 的 模式 。 让 我 们 思考 一 下 这 个 根 URL 一 一 
http:Wyourservercom。 乍 一 看 ， 此 类 URL 没有 匹配 路 由 。 然 而 ， 如 果 为 URL 参数 指定 一 个 
默认 值 ， 则 该 部 分 被 视 为 可 选 。 因 此 ， 对 于 前 面 的 示例 ， 当 你 请 求 根 URL 时 ， 该 请 求 会 通过 
调用 Home 控制 器 上 的 索引 方法 来 解决 。 


3. 处 理 路 由 


ASPNET 的 URL 路 由 模块 在 试图 将 传 入 请 求 的 URL 匹配 到 一 个 定义 好 的 路 由 时 采用 了 
一 些 规则 。 最 重要 的 规则 是 必须 以 在 global.asax 中 所 注册 的 顺序 来 检查 该 路 由 。 

为 确保 按 正 确 顺 序 处 理 该 路 由 ， 必 须 将 它们 按照 从 最 具体 到 最 不 具体 的 顺序 罗列 出 来 。 
在 任何 情况 下 ， 请 记 住 匹配 路 由 的 搜索 总 是 结束 于 前 个 匹配 。 这 意味 着 只 在 列表 底部 添加 一 
条 新 路 由 可 能 不 起 作用 ， 也 可 能 给 你 造成 肪 烦 。 此 外 ， 要 知道 在 列表 顶部 放置 一 个 党 统 的 模 
式 将 可 兼容 其 他 任何 模式 ， 不 管 这 个 模式 多 么 具体 、 多 么 容易 被 遗漏。 

除了 列 出 的 顺序 ， 其 他 因素 也 会 影响 给 URL 匹配 路 由 的 过 程 。 如 前 所 述 ， 其 中 一 个 就 是 
你 对 提供 给 路 由 的 默认 值 的 设置 。 默 认 值 其 实 就 是 自动 分 配 到 已 定义 占 位 符 的 值 ， 以 防 URL 
不 提供 具体 值 。 请 参考 下 和 面 两 个 路 由 : 

{Orders}/{Yearl}/{Month} 

{Orders}/{Yearl 

如 果 在 第 一 条 路 由 中 , 你 为 {Year} 和 {Month} 都 分 配 了 默认 值 , 那么 第 二 条 路 由 将 永远 不 
会 参与 判断 ， 因 为 第 一 条 路 由 有 了 默认 值 便 总 会 得 到 匹配 ， 无 论 URL 是 耕 指 定年 份 和 月 份 。 

结尾 的 正 斜 杜 () 也 是 一 个 陷阱 。 路 由 {Orders}/{fYear! 和 路 由 {OrdersY/{Year}/ 是 两 个 不 一 
样 的 东西 。 相 互 之 间 不 能 匹配 ， 尽 管 从 逻辑 上 看 起 来 确实 不 能 匹配 ， 但 至 少 从 用 户 的 角度 来 
看 ， 你 会 期 望 它 们 是 能 够 匹配 的 。 

为 一 个 影 啊 URL 与 路 由 匹配 的 因素 是 ,你 根据 需要 为 路 由 定义 了 约束 列表 。 路 由 约束 是 
给 定 URL 参数 必须 满足 以 匹配 路 由 的 附加 条 件 。URL 不 仅 应 该 与 URL 模式 兼容 ， 还 需要 包 
含 羔 容 的 数据 。 约 束 条 件 能 以 各 种 方式 定义 ， 包 括 通 过 正则 表达 式 。 下 面 是 一 个 市 有 约束 条 
件 的 路 由 示例 : 


routes .MapRoute 人 
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"BroductInito ”， 
"{controller}/{productId}/{1locale}™", 
new { controller = "Product"™", action = "Index™", locale="en—us"™ }, 


new { productId = @"\d{8}", 
locale = “"“™[a-z|] {2}-[a-z|] {2}™ }); 
尤其 是 该 路 由 要 求 productld 占 位 符 必 须 是 精确 8 位 数 的 数字 序列 , 而 locale 占 位 符 必须 
是 一 对 由 短 划 线 隔 开 的 两 个 字母 的 字符 串 。 约 束 条 件 并 不 能 确保 将 所 有 的 无 效 产品 ID 和 区 
域 设 置 代码 都 挡 在 门 外 ， 但 至 少 避 免 了 大 量 工 作 。 


4. 路 由 处 理 程 序 


路 由 定义 了 一 套 最 低 限 度 的 规则 ， 根 据 该 规则 路 由 模块 决定 传 入 的 请 求 URL 是 合 可 以 
伏 应 用 程序 接 党 。 节 终 决 定 如 何 重 新 映射 所 请 求 的 URL 的 组 件 则 完全 是 态 一 回 事 。 准 确 地 说 ， 
它 是 一 个 路 由 处 理 程序 。 路 由 处 理 程序 是 处 理 任 意 与 给 定 路 由 相 匹配 的 请 求 的 对 象 。 它 存在 
的 唯一 目的 是 返回 将 会 实际 为 任何 匹配 请 求 提供 服务 的 HITP 处 理 程 序 。 

从 技术 角度 看 , 路 由 处 理 程 序 是 一 个 实现 了 IRouteHandler 接口 的 类 。 接口 的 定义 如 下 所 
不 : 

Public interface IRouteHandler 

IHttpHandler GetHttpHandler (RequestcContext requestContext); 

} 

在 System.Web.Routing 名 称 空 间 中 定义 的 RequestContext 类 ， 封 装 了 请 求 的 HTIP 上 下 
文 以 及 任何 可 用 的 路 由 专用 信息 ， 比 如 Route 对 象 本 身 、URL 参数 和 约束 条 件 。 这 些 数 据 被 
分 组 到 一 个 RouteData 对 象 。 下 面 是 RequestContext 类 的 签名 : 


public class RequestContext 


{ 
public ReduestContext (HttpContextBase httpContext, RouteData routeData); 
// Properties 
public HttpContextBase HttpContext { get; set; } 
public RouteData RouteData { get; set; } 
} 


ASPNET MVC 框架 并 没有 提供 很 多 内 置 的 路 由 处 理 程序 ， 这 很 可 能 上 暗示 了 使 用 自 定义 
路 由 处 理 程 序 的 需求 并 不 普 裔 。 但 是 可 扩展 点 是 存在 的 ， 万 一 需要 你 还 可 以 利用 它 。 稍 后 将 
回 到 自 定义 路 由 人 处理 程序 的 内 容 ， 并 在 本 半 后 面 提供 一 个 示例 。 
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5. 处 理 物理 文件 的 请 求 


有 助 于 URL 与 路 由 成 功 匹配 的 路 由 系统 的 另 一 个 可 配置 的 方面 是 ,路 由 系统 是 售 要 处 理 
匹配 物理 文件 的 请 求 。 

默认 情况 下 ，ASPNET 路 由 系统 会 忽略 那些 其 URL 可 以 映射 到 实际 存在 于 服务 器 上 的 
文件 的 请 求 。 请 注意 ， 如 果 服 务 器 文件 存在 ， 则 路 由 系统 将 忽略 该 请 求 ， 即 使 请 求 匹配 了 
路 由 。 

如 果 需 要 , 则 可 以 通过 把 RouteCollection 对 象 的 RouteExistingFiles 属性 设置 为 true 来 强 
制 路 由 系统 处 理 所 有 的 请 求 ， 如 下 所 示 : 

// In global.asax.cs 

public static vold RegisterRoutes (RouteCollection routes) 

{ 


routes.RouteExistingFiles = true; 


} 

注意 ， 通 过 路 由 来 处 理 所 有 请 求 可 能 会 在 ASPNET MVC 应 用 程序 中 造成 几 个 问题 。 比 
如 ， 如 果 在 一 个 示例 ASPNET MVC 应 用 程序 的 global.asax.cs 文件 中 添加 上 述 代 码 并 运行 
该 应 用 程序 ， 那 么 在 访问 default.aspx 时 就 会 立即 出 现 一 个 HTTP 404 错误 。 


6. 阻止 已 定义 的 URL 路 由 


ASPNET 的 URL 路 由 模块 不 会 将 你 限制 在 维持 可 接受 的 URL 列表 的 模式 中 ; 也 可 以 天 
闭 某 些 URL 的 路 由 机 制 。 可 以 使 用 两 个 步骤 阻止 路 由 系统 处 理 某 些 URL。 首先 , 为 这 些 URL 
定义 一 个 模式 并 保存 到 一 个 路 由 。 第 二 ， 将 该 路 由 链接 到 一 个 专门 的 路 由 处 理 程序 一 一 
StopRoutingHandler 类 。 其 结果 就 是 在 调用 GetHttpHandler 方法 时 会 抛 出 一 个 NotSupported 
开 币 。 

例如 ， 以 下 代码 指示 路 由 系统 忽略 任何 .axd 请 求 : 

// In global.asax.cs 

Public static vold RegisterRoutes (RouteCollection routes) 

{ 


routes.IgnoreRoute("{resource}.axd/{*pathIinfo}™"); 
} 
IenoreRoute 所 做 的 就 是 将 StopRoutingHandler 路 由 处 理 程序 关联 到 围绕 指定 URL 模式 


所 构建 的 路 由 上 。 
最 后 需要 简单 解释 该 URL 中 的 {* pathInfo} 占 位 符 。pathInfo 令 牌 仅仅 表示 遵循 .axd URL 
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的 任意 内 容 的 占 位 符 。 但 是 星 写 (*) 表 示 最 后 一 个 参数 必须 匹配 该 URL 的 其 他 部 分 。 换 句 话 
说 ， 遭 循 -axd 扩展 名 的 所 有 内 容 都 会 有 一 个 pathInfo 参数 。 这 种 参数 称 为 通配符 参数 。 


7. 路 由 特性 


包含 在 ASPNET MVC 5 中 的 一 个 受 欢迎 的 NuGet 包 是 AttributeRouting( 参 见 http:// 
attributerouting.net)。 路 由 特性 就 是 使 用 特性 直接 在 控制 器 操作 上 定义 路 由 。 正 如 之 前 并 述 过 
的 ， 经 典 路 由 是 基于 应 用 程序 局 动 时 在 global.asax 中 所 建立 的 约定 。 

任何 时 候 一 个 请 求 进来 ，URL 都 会 与 已 注册 的 路 由 模板 进行 匹配 。 如 果 找 到 匹配 项 ， 就 
会 确定 处 理 该 请 求 的 合适 控制 器 和 操作 方法 。 如 果 没 有 找到 ， 请 求 会 被 拒绝 ， 结 果 通 常 是 一 
个 404 消息 。 如 今 在 大 型 应 用 程序 中 ， 甚 至 是 具有 较 绰 REST 风格 的 中 型 应 用 程序 中 ， 路 由 
的 数目 都 可 能 相当 大 ， 且 很 容易 迅速 达到 数 百 的 规模 。 你 可 能 会 很 快 发 现 ， 经 典 路 由 变 得 有 
点 疲 于 处 理 了 。 出 于 这 个 原因 ，AttributeRouting 项 目 启动 了 ， 日 前 已 经 集成 在 ASPNET 
MVC 5 中 ， 甚 至 在 Web API 中 ， 这 将 在 第 10 章 “Web API 的 执行 指南 ”中 讨论 。 

[HttpGet ("orders/{orderId}/show")] 

public ActionResult GetOrderBylId (int orderId) 

| 

} 

该 代码 将 GetOrderById 方法 设置 为 当 URL 模板 匹配 了 所 指定 的 模式 时 才 可 用 于 HTTP 
GET 调用 。 路 由 参数 一 orderId 令 牌 一 一 必须 匹配 方法 签名 中 所 定义 的 参数 之 一 。 有 更 多 的 
一 些 特 性 可 用 (用 于 每 个 HITP 动词 )， 但 主要 的 路 由 特性 都 在 这 里 了 。 欲 知 更 多 信息 (比如 配 
置 )， 可 以 参阅 http://attributerouting.net， 因 为 这 个 ASPNET MVC 的 集成 是 现 有 NuGet 包 的 
百 接 体现 。 


1.2 ”控制 器 类 


尽管 在 ASPNET MVC 名 称 中 就 明确 涉及 了 模型 -视图 -控制 占 模 式 , ASPNET MVC 的 架 
构 本 质 上 还 是 集中 于 一 个 支柱 一 一 控制 器 。 控 制 器 控制 请 求 的 处 理 ， 并 协调 后 端 系统 (例如 业 
务 层 、 服 务 、 数 据 访问 层 ) 抓 取 用 于 响应 的 原始 数据 。 接 着 控制 器 会 把 为 请 求 所 计算 的 原始 数 
据 打 包 成 调用 方 的 有 效 啊 应 。 当 啊 应 是 一 个 标记 视图 时 ， 控 制 器 会 依赖 视图 引擎 模块 将 数据 
和 视图 模板 结合 起 来 ， 生 成 HTML。 


1.2.1 控制 器 的 特征 
通过 URL 路 由 和 俑 选 器 的 任何 请 求 都 被 映射 到 一 个 控制 器 类 ,通过 执行 类 上 的 给 定 方法 来 
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进行 服务 。 因 此 ， 控 制 器 类 是 开 友 人 员 编 写实 际 代码 的 地 方 ， 这 些 代码 为 请 求 提 供 所 需 的 服 
务 。 让 我 们 简单 探讨 一 下 控制 器 的 一 些 特 征 。 


1. 控制 大 的 粒度 


ASPNET MVC 应 用 程序 通常 包括 各 式 各 样 的 控制 器 类 。 那 么 你 应 该 拥有 多 少 种 控制 器 
昵 ? 实 际 数量 取决 于 你 自己 ， 取 决 于 你 希望 如 何 组 织 应 用 程序 的 操作 。 事 实 上 ， 可 以 制作 一 
个 包含 单个 控制 器 类 的 应 用 程序 ， 该 控制 器 类 用 于 包含 任何 可 能 请 求 的 方法 。 

第 见 的 做 法 包括 为 应 用 程序 所 实现 的 每 个 重要 功能 配备 一 个 控制 嚣 类。 例如， 创建 一 个 
CustomerController 类 ， 人 负责 与 查询 、 删 除 、 更 新 和 插入 客户 信息 等 有 关 的 请 求 。 同 样 可 以 创 
建 一 个 ProductController 类 用 于 处 理 产 品 信 息 ， 诸 如 此 类 等 等 。 多 数 情况 下 ， 这 些 对 象 与 应 
用 程序 主 染 单 中 的 项 直接 相关 。 

大 体 来 说 ， 控 制 器 的 粒度 是 一 种 用 户 界 面 的 粒度 功能 。 应 该 为 每 一 个 你 在 用 户 界 面 中 所 
拥有 的 请 求 的 重要 来 源 规划 一 种 控制 占 。 


2. 无 状态 组 件 


所 选 控 制 器 类 的 新 实例 是 针对 每 个 请 求 而 实例 化 的 。 你 可 能 会 回 类 中 添加 的 任何 状态 都 
将 绑 定 到 相同 的 请 求生 命 周 期 中 。 随 后 控制 器 类 必须 能 够 从 HITP 请 求 流 和 HTTP 上 下 文中 
检索 到 它 需 要 使 用 的 任何 数据 。 


3. 进一步 的 分 技 取 决 于 你 


很 多 时 候 ，ASPNET MVC 和 控制 器 类 就 相当 于 你 挥舞 的 一 根 魔杖 ， 可 以 随意 编写 更 为 
简洁 和 容易 阅读 与 维护 的 分 层 代 码 。 控 制 左 类 的 无 状态 特性 在 这 方面 起 了 很 大 作用 ， 但 这 还 
不 够 

在 ASPNET MVC 中 ， 控 制 器 被 触发 该 请 求 的 用 户 界 面 和 产生 浏览 器 视图 的 引 敬 分隔 开 
来 ,控制 器 位 于 视图 与 系统 后 端 之 间 。 虽然 与 视图 的 这 种 分 隔 是 很 好 的 , 并 且 弥 补 了 ASPNET 
Web Forms 的 薄弱 点 ， 但 仅仅 如 此 并 不 能 确保 你 的 代码 会 受到 严格 的 关注 点 分 离 (SoC， 
Separation of Concerns) 原 则 的 认可 。 

该 系统 为 你 提供 了 与 视图 分 离 的 最 低级 别 一 一 其 他 一 切 都 取决 于 你 。 请 记 住 没 有 什么 会 
阻止 你 直接 在 控制 器 类 中 直接 使 用 ADO.NET 调用 和 浅显 的 TRANSACT-SQL(T-SQL) 语 句 ， 
即使 是 在 ASPNET MVC 中 也 不 会 。 控 制 器 类 不 是 系统 后 端 ， 也 不 是 业务 层 。 相 反 ， 它 应 当 
被 视 为 Web Forms 代码 隐藏 类 的 MVC 配对 物 。 因 此 ， 它 绝对 属于 表示 层 ， 而 非 业 务 层 。 


4. 高 度 可 测试 性 
控制 器 固有 的 无 状态 性 以 及 与 视图 的 简洁 分 离 使 控制 器 类 有 具备 了 易于 测试 的 潜力 。 然 
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而 ， 要 衡量 它们 的 真正 可 测试 性 还 应 该 针对 其 有 效 分 层 。 让 我 们 来 看 图 1-3。 

虽然 可 以 为 控制 器 类 提供 任何 你 喜欢 的 固定 输入 ， 它 的 输出 也 可 以 断言 没有 重大 问题 ， 
但 操作 方法 的 内 部 结构 却 没什么 好 说 的 。 这 些 方法 的 实现 与 外 部 资源 (比如 数据 库 、 服 务 、 组 
件 ) 绑 定 程度 越 紧密 ， 控 制 器 就 越 不 能 便捷 地 进行 测试 。 


啊 应 


攻 六 | 视图 引擎 


图 1-3 ASPNET MVC 中 的 控制 器 和 视 图 


1.2.2 编写 控制 兹 类 

控制 器 类 的 编写 可 以 概括 为 两 个 简单 的 步骤 : 第 一 ， 创 建 从 Controller 继承 (直接 或 间接 
均 可 ) 而 来 的 类 ; 第 二 ， 添 加 一 系列 的 公共 方法 。 然 而 ， 必 须 阐明 两 个 重要 的 细节 : 系统 如 何 
获知 控制 器 类 要 实例 化 ， 以 及 它 如 何 确定 要 调用 的 方法 。 


1. 从 路 由 到 控制 铺 


不 论 你 如 何 定 义 URL 模式 ， 任 何 请 求 都 必须 根据 控制 器 名 称 和 操作 名 称 来 解析 。 这 是 
ASPNET MVC 的 一 个 文 柱 。 如 果 URL 包含 了 一 个 {fcontroller } 占 位 符 ， 那么 控制 器 名 称 会 目 
动 从 URL 中 读 取 。 如果 URL 包含 了 {action} 占 位 从 ,那么 操作 名 称 也 将 从 URL 中 目 动 读 取 。 

然而 ,缺乏 这 些 占 位 符 的 完全 目 定 义 URL 仍然 是 可 以 接受 的 。 但 这 种 情况 下 ， 需 要 由 你 
通过 默认 值 来 指示 控制 器 和 操作 ， 如 下 所 示 : 

roOoutes .MapRoute ( 

"SampleRoute", 
"about™, 
new { controller = "Home™, action = "About"™} 

); 

如 果 控 制 器 和 操作 名 称 不 能 以 静态 方式 得 到 解析 ， 就 可 能 需要 编写 一 个 目 定 义 路 由 处 理 
程序 ， 以 获得 请 求 的 详细 信息 ， 再 找 出 控制 器 和 操作 的 名 称 。 然 后 只 需要 把 它们 存储 在 
RouteData 集合 中 即 可 ， 如 下 所 示 : 

public class AboutRouteHandler : IRouteHandler 

{ 

public IHttpHandler GetHttpHandler (RequestContext requestContext) 
{ 
if (requestContext .HttpContext.Request.Url.AbsolutePath == "/about™") 
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reduestcContext .RouteData-ValLues[- -controlLLer | = "home"; 
redquestContext .RouteData.-Values["actlon"] = "about"; 
} 


return new MvcHandler (requestContext); 


} 
对 于 一 个 需要 自 定 义 处 理 程序 的 路 由 ， 其 注册 过 程 与 你 早先 看 到 的 有 所 不 同 。 这 里 是 你 
需要 在 RegisterRoutes 中 编写 的 代码 : 


public static vold RegisterRoutes (RouteCollection routes) 


{ 
Var aboutRoute = new Route("about™", new AboutRouteHandler ()); 
routes.Add ("SampleAboutRoute", aboutRoute); 


} 

请 务必 注意 ， 从 路 由 模块 获得 的 控制 右 名 称 并 不 能 完全 匹配 将 被 调用 的 类 的 实际 名 称 。 
默认 情况 下 ， 控 制 器 类 是 以 控制 器 名 称 加 上 一 个 Controller 后 级 来 命名 的 。 在 前 面 的 示例 中 ， 
如 果 home 是 控制 夯 的 名 称 ， 那 么 该 关 的 名 称 束 被 设 定 为 HomeController。 注 意 这 一 约定 个 
只 适用 于 类 的 名 称 ， 也 适用 于 名 称 空 间 。 尤 其 是 当 该 类 会 作用 于 默认 项 目 名 称 空 间 下 的 
Controller 名 称 空 团 时 。 


注意 : 

当 基 于 以 编程 方式 设置 控制 器 和 操作 名 称 的 自 定义 路 由 处 理 程序 来 添加 一 个 路 由 时 ， 可 
能 会 在 由 Html.ActionLink 帮助 器 所 生成 的 链接 方面 遇 到 麻烦 ,该 帮助 器 通常 用 于 为 用 户 界面 
的 菜单 和 其 他 可 视 化 元 条 创建 基于 路 由 的 链接 。 如 果 用 自 定义 处 理 程序 添加 了 一 个 路 由 ， 你 
可 能 会 惊讶 地 发 现 从 帮助 器 获得 的 链接 竟然 是 基于 这 个 路 由 的 。 为 解决 这 个 问题 ， 要 么 你 把 
ActionLink 更 改 为 RouteLink， 并 明确 表示 你 布 望 URL 根据 哪个 路 由 来 创建 ， 要 么 你 在 自 定 
义 路 由 中 明确 规定 控制 器 和 操作 都 是 可 选 参数 。 


2. 从 路 由 到 操作 


当 ASPNET MVC 的 运行 时 环境 具有 所 选 控制 器 类 的 有 效 实例 时 ， 它 会 服从 操作 调用 程 
序 组 件 以 便 请 求 的 实际 执行 。 操 作 调 用 程序 会 获取 操作 的 名 称 并 尝试 将 其 匹配 到 控制 器 类 的 
公共 方法 。 

操作 参数 会 指定 要 执行 的 操作 名 称 。 大 多 数 情况 下 , 控制 器 类 已 经 具有 一 个 同名 的 方法 。 
如 果 是 这 样 ， 调 用 程序 会 执行 它 。 注 意 ， 尽 管 如 此 ， 你 还 是 可 以 将 操作 名 称 特性 关联 到 任何 
公共 方法 ， 因 此 需要 将 方法 名 称 从 操作 名 称 解 厢 。 下 面 是 一 个 示例 : 
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public class HomeController : Controller 


{ 
// Implicit action name: Index 
public ActionResult Index() 
{ 


} 


[NonAct1ionl] 
public ActionResult About () 
{ 


} 


[ActionName ("About")] 
public ActionResult LoveGermanshepherds () 
{ 


} 
} 


Index 方法 是 不 用 特性 修饰 的 ， 所 以 它 是 以 相同 的 名 称 隐 式 绑 定 到 操作 的 。 第 三 种 公共 
方法 有 一 个 非常 古怪 的 名 字 , 但 它 是 通过 ActionName 特性 显 式 绑 定 到 About 操作 的 。 最 后 ， 
请 注意 如 果 要 防止 一 个 公共 控制 器 方法 被 隐 式 绑 定 到 一 个 操作 名 称 ， 就 需要 使 用 NonAction 
特性 ,因此 , 从 前 面 的 代码 段 来 看 , 当 用 户 请 求 about 操作 时 , 就 会 运行 LoveGermanShepherds 
方法 ， 而 不 论 HTTP 动词 是 否 曾 用 于 设置 该 请 求 。 

3. 操作 和 HTTP 动词 

ASPNET MVC 足够 灵活 ， 可 以 让 你 将 方法 绑 定 到 用 于 特定 HTTP 动词 的 操作 。 要 将 控 
制 器 方法 与 HTTP 动词 关联 ， 可 以 使 用 参数 化 的 AcceptVerbs 特性 ， 也 可 以 使 用 直接 特性 ， 
如 HttpGet、HttpPost 和 HttpPut 等 。 使 用 AcceptVerbs 特性 ， 可 以 指定 需要 哪个 HITP 动词 来 
执行 给 定 的 方法 。 让 我 们 看 看 下 面 的 示例 : 

[AcceptVerbs (HLLPVerbs .Post) ] 

public ActionResult Edit (Customer customer) 

{ 

} 

对 于 该 代码 来 说 ， 其 结果 是 Edit 方法 不 能 通过 使 用 GET 来 调用 。 另 外 需要 注意 的 是 ， 
单个 方法 不 能 有 多 个 AcceptVerbs 特性 。 如 果 在 操作 方法 上 添加 了 多 个 AcceptVerbs 特性 (或 
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类 似 的 直接 HITP 动词 特性 )， 你 的 代码 是 不 能 编译 通过 的 。 


AcceptVerbs 特性 会 从 HttpVerbs 枚 举 类 型 中 提取 值 : 


public enum HttpVerbs 


{ 
Get = 1, 
Post = 2 
Put = 4, 
Delete = 8， 
Head = OQxl0 
} 


HttpVerbs 枚 举 由 Flags 特性 修饰 ,所 以 可 以 通过 使 用 按 位 OR(]) 运 算 和 从 将 来 自 枚 举 类 型 的 


多 个 枚 举 值 结 合 到 一 起 ， 同 时 获得 另 一 个 HttpVerbs 值 。 


[AcceptVerbs (HELPVerbs .Post1HLLPVerbs .Put) 
public ActionResult Edit (Customer customer) 
{ 


} 
当 单 击 一 个 链接 或 在 地 址 栏 中 键入 URL 时 ， 就 执行 了 一 个 HTTP GET 命令 。 当 提交 一 


个 HTML 表单 的 内 容 时 ， 就 执行 了 一 个 HTTP POST 命令 。 可 以 只 通过 AJAX 执行 其 他 基 个 


HTTP 命令 ， 也 可 以 从 Windows 客户 端 把 请 求 发 送 到 ASPNET MVC 应 用 程序 。 
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将 特定 动词 分 配 到 给 定 操作 方法 的 能 力 很 目 然 地 会 导致 重 复 的 方法 名 称 。 具 有 相同 名 称 


的 两 种 方法 在 控制 器 类 中 都 可 以 被 接受 ， 只 要 它们 接受 不 同 的 HTTP 动词 。 人 否则 ， 将 引发 异 
第 ， 因 为 ASPNET MVC 不 知道 如 何 解 术 一 词 多 义 的 情况 。 


注意 : 


还 可 以 使 用 多 个 单独 的 特性 ， 每 个 特性 用 于 一 个 HITP 动词 。 比 如 HttpGet 和 HttpPost.。 
4. 操作 方法 


让 我 们 来 看 一 个 控制 器 类 的 示例 ， 该 示例 中 有 一 些 简 蛙 而 实用 的 操作 方法 : 
public class HomeController : Controller 
{ 


public ActionResult Index () 
{ 


// Process input data 


// Perform expected task 
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// Generate the result of the action 
return VLewr) ; 


} 


public ActionResult About () 
{ 


// Process input data 


// Perform expected task 


//: Generate the result of the action 
return View(); 


} 
操作 方法 通过 使 用 任意 的 标准 HTTP 通道 抽取 可 用 的 输入 数据 。 接 看 ， 它 会 准备 一 些 操 
作 ， 并 可 能 涉及 应 用 程序 的 中 间 层 。 我 们 可 以 将 操作 方法 的 模板 总 结 如 下 : 

。 处 理 输入 数据 操作 方法 可 以 从 两 个 来 源 获取 输入 参数 ， 由 Request 对 象 所 公开 的 路 
由 值 和 集合 。ASP.NET MVC 并 不 强制 要 求 专 门 的 操作 方法 签名 。 然而， 出 于 可 测试 
性 的 考虑 ， 强 烈 建议 任何 输入 参数 都 通过 签名 来 接收 。 如 果 可 以 的 话 ， 最 好 避免 以 编 
程 方 式 从 请 求 或 其 他 来 源 检索 输入 数据 的 方法 。 你 将 在 本 章 后 面 看 到 ， 当 然 在 第 3 章 

“模型 绑 定 架构 ”中 会 更 全 面 地 了 解 ， 存 在 着 一 个 子 系统 一 一 模型 绑 定 层 一 一 用 于 将 
HTTP 参数 映射 到 操作 方法 参数 。 

。 执行 任务 “操作 方法 基于 输入 参数 进行 工作 , 并 尝试 获得 预期 的 结果 。 在 这 个 过 程 中 ， 
操作 方法 可 能 需要 与 中 间 层 交互 。 正 如 第 7 章 “ 设 计 ASPNET MVC 控制 器 的 注意 事 
项 ”中 的 详尽 探讨 所 建议 的 ， 任 何 交 互 都 需要 通过 特 设 的 专用 服务 进行 。 在 任务 结束 
时 ， 任 何 应 集 成 到 吧 应 中 的 (计算 或 引用 的 ) 值 都 会 进行 适当 的 封装 。 如 果 方 法 返回 
JavaScript 对 象 标志 (JavaScript Object Notation，JSON)， 则 数据 会 组 成 一 个 JSON 序 
列 化 的 对 象 。 如 果 方 法 返回 HTML， 则 数据 被 封装 成 一 个 容器 对 象 ， 并 友 送 到 视图 引 
擎 。 容 器 对 象 通 利 也 称 为 视图 模型 ， 可 以 是 一 对 名 称 / 值 的 浅显 字典 ， 或 者 是 特定 的 
视图 强 类 型 类 。 

e 生成 结果 在 ASP.NET MVC 中 ,控制 器 的 方法 不 负责 产生 啊 应 本 里 。 不 过 ,使 用 一 
个 特别 的 对 象 ( 通 第 为 视图 对 象 ) 将 内 容 提 交 给 输出 流 这 个 过 程 却 是 由 它 负 责 的 。 控 制 
露 的 方法 会 标识 啊 应 的 类 型 (文件 、 普 通 数据 、HITML、JavaScript 或 JSON)， 并 设置 
一 个 适当 的 ActionResult 对 象 。 
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控制 器 的 方法 预期 会 返回 一 个 ActionResult 对 象 ， 或 一 个 继承 ActionResult 类 的 对 象 。 
但 通常 情况 下 ， 控 制 器 方法 并 不 会 直接 实例 化 ActionResult 对 象 。 相 反 ， 它 使 用 一 个 操作 帮 
助 器 一 即 一 个 内 部 实例 化 的 对 象 ， 并 返回 一 个 ActionResult 对 象 。 前 面 示例 中 的 View 方法 
提供 了 一 个 操作 帮助 器 的 最 佳 例子 。 操 作 帮 助 器 方法 的 另 一 个 好 例子 是 Json， 在 方法 需要 返 
回 一 个 JSON 字符 串 的 时 候 使 用 。 马 上 将 会 谈 到 这 一 点 。 


1.2.3 ”处 理 输入 数据 


控制 器 操作 方法 可 以 访问 任何 通过 使 用 HTTP 请 求 而 提交 的 输入 数据 。 输 入 数据 可 以 从 
各 种 来 源 检索 ， 包 括 表 单数 据 、 查 询 字 符 串 、Cookies、 路 由 值 和 提交 文件 。 

控制 右 操 作 方 法 的 签名 是 随意 的 。 如 果 定 义 了 不 市 参数 的 方法 ， 束 需要 目 己 负责 以 编程 
方式 来 检索 代码 所 需 的 任何 输入 数据 。 如 果 将 参数 添加 到 方法 签名 中 ， 那 么 ASPNET MVC 
会 提供 自动 的 参数 解析 。 尤 其 是 ，ASPNET MVC 会 尝试 将 正式 参数 的 名 称 与 请 求 作 用 域 字 
典 中 的 命名 成 员 相 匹配 ， 请 求 作 用 域 字典 会 将 来 自 查 询 字 符 串 、 路 由 、 提 交 表 单 等 的 值 连接 

在 这 一 章 中 探讨 了 如 何 从 控制 器 操作 方法 内 手动 检索 输入 数据 。 第 3 章 将 讨论 自动 参数 
解析 一 一 ASPNET MVC 应 用 程序 中 最 和 常见 的 选择 。 


1. 获取 Request 对 象 中 的 输入 数据 


在 编写 操作 方法 的 主体 时 ， 你 当然 可 以 访问 传 给 Request 对 象 及 其 子 集 的 任何 数据 ， 这 
些 Request 对 象 及 子 集 包括 Form、Cookies、ServerVariables 和 QueryString。 在 本 书 的 后 面 内 
容 你 会 看 到 ， 在 控制 器 方法 的 输入 参数 方面 ，ASPNET MVC 会 提供 相当 有 吸引 力 的 工具 (如 
模型 绑 定 右 )， 可 以 使 你 的 代码 更 干 滔 简 洁 和 易于 测试 。 话 虽 如 此 ,但 你 依然 可 以 编写 旧 样 式 
的 基于 请 求 的 代码 ， 如 下 所 示 : 

public ActionResult Echo () 

{ 


// Capture data in a manual way 
Var data = Request.Params["today"] ?2 String.Empty; 


} 

在 ASPNET 中 ， Request.Params 字典 产生 于 四 个 不 同 字 — 典 的 组 合 , 即 QueryString、 Form.、 
Cookies 和 ServerVariables。 也 可 以 使 用 Request 对 象 的 Item 索引 器 属性 ， 它 会 提供 一 样 的 功 
能 ， 并 按 以 下 顺序 在 字典 中 搜索 匹配 项 : QueryString、Form、Cookies 和 ServerVariables。 下 
面 的 代码 完全 等 同 于 刚刚 所 示 的 : 


public ActionResult Echo () 
{ 
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// Capture data in a manual way 
Var data = Request["today"] ?2? String.Empty; 


} 
注意 对 匹配 项 的 搜索 是 不 区 分 大 小 写 的 。 
2. 从 路 由 中 获取 输入 数据 


在 ASPNET MVC 中 ,通常 会 通过 URL 提供 输入 的 参数 。 这 些 值 由 路 由 模块 捕获 ， 并 可 
供应 用 程序 使 用 。 路 由 值 不 通过 Request 对 象 向 应 用 程序 公开 。 你 要 使 用 一 个 稍微 不 同 的 方 
法 以 编程 方式 检索 它们 ， 如 下 所 示 : 

Public ActionResult Echo() 

{ 


// Capture data In a manual way 
Var data = RouteData.Values["data"] ?2? String.Empty; 


} 

路 由 数据 是 通过 Controller 类 的 RouteData 属性 公开 的 。 同 样 ， 在 这 种 情况 下 ， 对 岂 配 项 
四 索 不 用 区 分 大 小 写 。 

RouteData.Values 字典 是 一 个 字符 串 / 对 象 字典 。 大 多 数 时 候 该 字典 只 包含 字符 串 。 但 是 ， 
如 果 以 编程 方式 填充 该 字典 (比如 通过 自 定义 路 由 处 理 程序 )， 那 么 它 就 可 以 包含 其 他 类 型 的 
值 。 这 种 情况 下 ， 需 要 手动 进行 必要 的 类 型 强制 转换 。 


3. 从 多 个 来 源 获 取 输 入 数据 


当然 ， 可 以 在 同一 控制 器 方法 中 混合 使 用 RouteData 和 Request 调用 。 举 例 来 说 ， 让 我 
们 考虑 下 和 面 的 路 由 : 


routes .MapRoute ( 
"EchoRoute™, 
"echo/ {data}™", 
new { controller = "Home", action= "Echo", data = UrlParameter.Optional } 


的 


) 7 
http://yourserver/echo/Sunday 是 一 个 有 效 的 URL。 接 下 来 显示 的 代码 将 很 容易 抽取 到 数 
据 参 数 (Sunday) 的 值 。 以 下 是 HomeController 类 的 Echo 方法 的 一 种 可 能 实现 : 
public ActionResult Echo () 
{ 
// Capture data in a manual way 


Var data = RouteData.Values|["data™"|; 
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} 
如 果 调用 下 面 的 URL， 又 会 怎样 ? 
http://yourserver/echo?today=3/27/2011 


该 URL 仍然 会 匹配 路 由 模式 , 但 它 不 提供 数据 参数 的 值 。 不 过 , 出 于 控制 磺 操 作 的 考虑 ， 
URL 会 在 查询 字符 串 中 添加 一 些 输入 值 。 下 面 是 支持 这 两 种 方案 的 修订 版 Echo 方法 : 
public ActionResult Echo() 
| 
// Capture data in a manual way 
Var data = RouteData.Values["data™"| 2°? 
(Request .Params["today"] ?2 String.FEmpty); 


} 
问题 是 ,“ 我 应 该 为 每 个 可 能 的 输入 通道 都 规划 一 个 不 同 的 代码 分 支 吗 ， 比 如 表单 数据 、 
查询 字符 嘻 、 路 由 、Cookies 等 ? ”让 我 们 继续 阅读 ValueProvider 字典 一 节 。 


4. ValueProvider 字 上 暴 


在 Controller 类 中 ，ValueProvider 属性 只 会 为 从 各 种 来 源 收 集 到 的 输入 数据 提供 单个 容 
器 。 默 认 情 况 下 ，ValueProvider 字典 由 来 自 下 列 源 的 输入 值 ( 按 特定 顺序 ) 填 充 : 

(1) 子 操 作 值 ”输入 值 由 子 操作 方法 调用 来 提供 。 子 操作 是 对 来 源 于 视图 的 控制 器 方法 
的 调用 。 当 视图 回调 控制 器 以 获取 额外 数据 或 要 求 执 行 一 些 可 能 会 影响 正在 提交 的 输出 的 特 
殊 任务 时 ， 就 会 发 生子 操作 调用 。 相 关内 容 将 会 在 第 2 章 “ASPNETMVC 视图 ”中 探讨 。 

(2) 表单 数据 ”输入 值 由 提交 的 HTML 表单 中 所 输入 字段 的 内 容 提 供 。 该 内 容 与 你 通过 
Request Form 获得 的 内 容 相同 。 

(3) 路 由 数据 输入 值 由 与 当前 所 选 路 由 中 所 定义 的 参数 相关 联 的 内 容 提供 。 

(4) 查询 字符 串 ”输入 值 由 当前 URL 的 查询 字符 串 中 所 指定 的 参数 内 容 提 供 。 

(5) 提交 的 文件 ”输入 值 在 当前 请 求 的 上 下 文中 通过 HTTP 提交 的 文件 来 表示 。 

ValueProvider 字典 提供 了 一 个 以 GetValue 方法 为 中 心 的 目 定义 编程 接口 。 下 面 是 一 个 
示例 : 


var result = ValueProvider.GetValue (rdatan) : 

要 知道 ，GetValue 不 会 返回 String 或 Object 类 型 。 相 反 ， 它 会 返回 ValueProviderResult 类 
型 的 一 个 实例 。 该 类 型 有 两 个 用 于 实际 读 取 真 实 参 数值 的 属性 : RawValue 和 AttemptedValue。 
前 者 是 Object 类 型 ， 包 含 由 来 源 所 提供 的 原始 值 。AttemptedValue 属性 却 是 一 个 字符 串 ， 代 
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表 了 强制 转换 为 String 类 型 的 结果 。 下 面 是 如 何 使 用 ValueProvider 来 实现 Echo 方法 的 示例 


代 但 。 
public ActionResult Echo () 
{ 

Var data = ValueProvider.GetValue ("data") .AttemptedValue ?2 
(ValueProvider.GetVvalue ("today") .AttemptedValue ?2? 
string.Empty); 

} 


说 到 参数 名 称 ，ValueProvider 比 Request 和 RouteData 的 要 求 更 高 一 些 。 如 果 参 数 的 大 小 
写 输 入 错误 ， 会 得 到 一 个 从 GetValue 返回 的 null 对 象 。 如 果 之 后 只 是 读 取 值 而 不 检查 为 空 的 
结果 对 象 ， 就 会 导致 一 个 异常 。 

最 后 要 注意 的 是 ， 默 认 情况 下 你 不 能 通过 ValueProvider 字典 获得 对 Cookies 的 访问 权 。 
然而 ， 通 过 定义 一 个 实现 IValueProvider 接口 的 类 ， 值 提供 器 列表 可 以 以 编程 方式 得 到 扩展 。 


注意 : 

值 提供 器 机 制 可 用 于 检索 一 些 封杀 到 合 庆 的 值 集合 的 请 求 数据 。 默 认 的 值 提供 器 将 你 从 
查询 QueryString 慌 Form 集合 的 负担 中 解救 了 出 来 .如 果 需 要 从 一 个 Cookie 或 一 个 请 求 标 头 
中 读 取 数 据 呢 ? 可 以 走 传 统 路 子 ， 读 取 Request 对 得 的 Header 或 Cookies 集合 ， 并 编写 代码 
提取 单独 的 值 。 然而， 如果 应 用 程序 广泛 地 基于 请 求 标 头 或 Cookies， 那 么 就 可 能 需要 考虑 
编写 一 个 自 定义 的 值 提供 器 了 。 从 社区 网 站 上 不 难 发 现 这 两 种 情况 的 示例 。 可 以 在 
http://blog.donnfelker.com/2011/02/16/asp-net-mvec-buildine-web-apis-with-headervalueprovider 
找到 公开 请 求 标 头 的 值 提 供 器 的 一 个 好 例子 。 

1.2.4 产生 操作 结果 

一 个 操作 方法 可 以 产生 多 种 结果 。 例 如 ， 一 个 操作 方法 可 以 只 用 作 Web 服务 ， 并 在 对 请 
求 的 响应 中 返回 普通 字符 串 或 JSON 字符 串 。 同 样 ， 操 作 方法 可 以 确定 是 否 不 返回 内 容 或 需 
要 重 定向 到 男 一 个 URL。 这 两 种 情况 下 ， 浏 览 器 都 只 会 得 到 一 个 HTTP 啊 应 ， 而 没有 太 多 内 
容 。 这 就 是 说 产生 操作 的 原始 结果 (例如 从 中 间 层 收集 值 ) 是 一 方面 ， 对 原始 结果 进行 处 理 生 
成 用 于 浏览 器 的 实质 HITP 啊 应 是 另 一 方面 。ActionResult 类 代表 了 用 于 实现 该 编程 方面 的 
ASPNET MVC 基础 架构 。 

1. ActionResult 类 的 内 部 结构 


操作 方法 通常 会 返回 一 个 ActionResult 类 型 对 象 。 但 ActionResult 类 型 并 不 是 一 个 数据 
容器 。 更 确切 地 说 ， 它 是 一 个 抽象 类 ， 提供 通 用 编程 界面 ， 代 表 操 作 方 法 执行 进一步 的 操作 。 
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下 面 是 ActionResult 类 的 定义 : 


public abstract class ActionResult 


{ 

protected ActionResult () 

{ 

} 

public abstract void ExecuteResult (ControllerCcontext context).,; 
} 


通过 重 写 ExecuteResult 方法 , 派生 类 会 获得 访问 任何 由 操作 方法 的 执行 所 产生 的 数据 的 
权限 ， 并 触发 一 些 后 续 操 作 。 一 般 来 说 ， 这 些 后 续 操 作 与 一 些 浏览 器 的 啊 应 生成 有 关 。 


2. 预定 义 操作 结果 类 型 


由 于 ActionResult 是 一 个 抽象 类 型 ， 因 此 每 个 操作 方法 实际 上 都 要 求 返 回 一 个 更 具体 类 
型 的 实例 。 表 1-1 列 出 了 所 有 预定 义 的 操作 结果 类 型 。 


表 1-1 ASP.NET MVC 中 的 预定 义 ActionResult 类 型 


类 型 摘 述 

ContentResult 将 原始 内 容 (不 一 定 是 HTMND) 发 送 给 浏览 促 。 该 类 的 ExecuteResult 方法 会 将 接收 
的 所 有 扩容 序列 化 

EmptyResult 不 向 浏览 器 发 送 内 容 。 该 类 的 ExecuteResult 方法 不 处 理 任何 任务 

FileContentResult 将 一 个 文件 的 内 容 发 送 给 浏 归 事 。 访 文件 的 内 容 会 表示 成 一 个 字 太 数组 。 
ExecuteResult 方法 仅 会 将 该 字 广 数组 与 入 输出 流 中 

FilePathResult 将 一 个 文件 的 内 容 发 送 给 浏览 嚣 。 访 文件 由 其 路 往 和 内 容 类 型 进行 标识 。 
ExecuteResult 方法 会 在 HttpResponse 时 调用 TransmitFile 方法 

FileStreamResult 将 一 个 文件 的 内 容 友 送 给 浏览 艇 。 访 文件 的 内 容 会 值 助 一 个 Stream 对 象 来 表示 。 
ExecuteResult 方法 会 将 提供 的 文件 流 复 制 到 输出 流 

HttpNotFoundResult 将 一 个 HTTP 404 啊 应 代 公 发 送 给 浏览 器 .该 HTTP 状态 人 码 标 识 一 个 请 求 失 败 了 ， 


原因 是 该 请 求 的 资源 未 找到 
HttpUnauthorizedResult ”| 将 一 个 HITP 401 啊 应 代 公 发 送 给 浏览 占 。 该 HTTP 状态 公 标 识 一 个 未 授权 的 


请 求 

JavaScriptResult 将 JavaScript 文本 发 运 给 浏览 器 。 设 类 有 的 ExecuteResult 方法 会 输出 设 脚 本 开设 置 
相应 的 内 容 类 型 

JsonResult 将 一 个 JSON 字符 串 友 送 给 浏览 船 。 访 和 关 的 ExecuteResult 方法 会 为 应 用 程序 或 


JSON 设置 内 容 类 型 , 并 调用 JavaScriptSerializer 类 为 JSON 序列 化 提供 的 托管 对 象 
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( 续 表 ) 
Partial ViewResult 将 HIML 内 容 发 送 给 浏览 占 , 它 代表 整个 页 面 视图 的 一 个 片段 ASP.NET MVC 
中 视图 片段 的 概念 与 Web Forms 中 用 户 控件 的 概念 非常 相似 
RedirectResult 将 一 个 HTTP 302 啊 应 代 公 有 友 壕 给 浏 咒 右 以 将 浏 宛 强 叶 和 骨 到 指定 的 URL。 该 类 的 


ExecuteResult 方法 只 调用 Response.Redirect 
RedirectToRouteResult 了 束 像 RedirectResult，RedirectToRouteResult 会 将 一 个 HTTP 302 啊 应 代码 友 运 给 
浏览 副 并 草 定 问 到 一 个 新 的 URL。 不同 之 处 在 于 用 来 确定 目标 URL 所 采用 的 逻 
务 和 输入 数据 。 这 种 情况 下 ，URL 十 基于 操作 /控制 左 配 对 或 路 由 名 称 来 构建 的 
ViewResult 将 代表 完整 页 面 视图 的 HTML 内 容 友 送 给 浏览 郁 


注 量 ，FileContentResult、FilePathResult 和 FileStreamResult 是 从 同一 基 类 派生 而 来 的 ， 
该 基 类 是 : FileResult。 如 有 果 要 以 下 载 的 某 些 文件 内 容 或 者 一 些 表 示 为 字 节 数组 的 普通 二 进 制 
内 容 来 回复 请 求 , 那么 可 以 使 用 任何 一 个 上 述 操作 结果 对 象 。PartialViewResult 和 ViewResnult 
是 从 ViewResultBase 继承 而 来 的 ， 并 会 返回 HTML 内 容 。 最 后 ，HttpUnauthorizedResult 和 
HttpNotFoundResult 分 别人 代表 对 未 经 授权 的 访问 与 忠 少 资源 这 两 种 第 见 情况 的 啊 应 。 这 两 者 
都 从 可 进一步 扩展 的 HttpStatusCodeResult 类 派生 而 来 。 


3. 执行 操作 结果 的 机 制 


为 了 更 好 地 理解 操作 结果 类 的 机 制 , 让 我 们 剖析 一 个 预定 义 类 。 比 如 JavaScriptResult 类 ， 
它 提 供 了 一 些 人 向 单 而 有 意义 的 行为 。JavaScriptResult 类 表示 返回 一 些 脚 本 到 浏 宛 器 的 操作 。 
下 面 是 一 个 提供 了 JavaScript 代码 的 可 能 操作 方法 : 


public JavascriptResult GetScrlLpt 1() 
{ 


var script = "alert ('Hello')™; 
return Javascript (script); 
} 
在 这 个 示例 中 ，JavaScript 是 Controller 类 的 一 个 帮助 器 方 法 ,充当 J 了 JavaScriptResult 对 
象 工厂 的 角色 。 其 实现 如 下 : 
protected JavaSscriptResult JavaSsScript (string script) 
{ 
return new JavascriptResult() { Script = script }; 


} 
JavaScriptResult 类 提供 了 一 个 公共 属性 一 一 Script 属 性 一 一 它 包 含 了 会 写 入 输出 流 的 脚本 
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代码 。 其 实现 如 下 : 


public class JavascriptResult : ActionResult 


{ 
public String Script { get; set; } 
public override Vold ExecuteResult (ControllerContext context) 
{ 
1f (context == null) 
throw new ArgumentNullException ("context"™"); 
// Prepare the response 
HttpResponseBase response = context.HttpContext.Response; 
response.ContentType = "application/x-Javascript"; 
1f (Script != null) 
response.Write (Script); 
} 
} 


正如 你 所 看 到 的 ，ActionResult 类 的 最 终 目 的 是 准备 好 要 返回 到 浏览 器 的 HttpResponse 
对 象 。 这 就 需要 设置 内 容 类 型 、 过 期 策略 、 标 头 以 及 内 容 。 


返回 HTML 标记 


大 部 分 时 候 ， 请 求 是 通过 发 回 HTML 标记 来 处 理 的 。 构 成 用 于 浏览 器 的 HTML 是 Web 
框架 的 核心 所 在 。 在 ASPNET Web Forms 中 ， 构 成 HTML 的 任务 是 通过 页 面 完成 的 。 开 发 
人 员 创 建 ASPX 页 和 面 作为 视图 模板 和 代 人 码 隐 蕊 类 的 混合 容 右 。 抓 取 结 果 的 操作 与 实际 啊 应 的 
产生 ， 这 两 者 在 单一 的 运行 时 环境 中 是 难以 分 开 的 。 在 ASPNET MVC 中 ， 产 生出 结果 是 操 
作 方 法 的 责任 ; 省 理 啊 应 的 构成 和 服务 则 是 框架 的 责任 。 而 最 后 ,构成 HIML 标记 更 是 另 一 
个 系统 组 件 一 一 视图 引擎 一 一 的 责任 。 

第 2 章 将 介绍 视图 引擎 ， 现 在 只 能 说 视图 引擎 知道 如 何 为 给 定 的 操作 检索 视图 模板 ， 也 
知道 如 何 将 其 处 理 成 混合 了 模板 信息 和 原始 数据 的 普通 HIML 流 。 视 图 引擎 规定 了 视图 模板 
的 语法 (比如 ASPX、Razor 和 Spark); 而 由 开发 人 员 决 定 合并 到 视图 的 原始 数据 格式 。 让 我 
们 看 一 个 返回 HTML 的 示例 操作 方法 : 

public ActionResult Index() 

{ 


return View(); // same as View(n"inadexn) : 


} 


View 方法 是 一 个 帮助 器 方法 , 负责 创建 ViewResult 对 象 。ViewResult 对 象 需要 了 解 视图 
模板 、 可 选 的 母 版 视图 以 及 将 集成 到 最 终 HTML 的 原始 数据 。 在 上 述 代 码 段 中 ，View 没有 
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参数 并 不 意味 痢 没 有 数据 在 实际 传递 。 下 面 是 该 方法 签名 中 的 一 个 : 
protected ViewResult View (String viewName, String masterName, Object model) 


按照 约定 ， 视 图 模板 是 一 个 以 操作 名 称 (本 例 中 是 Index) 命 名 的 文件 ， 并 位 于 特定 的 文件 
夹 中 。 其 确切 位 置 取决 于 当前 所 选 视图 引擎 的 实现 。 默 认 情 况 下 ， 视 图 模板 应 该 位 于 与 控制 
荐 名称 相 匹配 的 目录 之 下 的 Views 文件 夹 中 一 一 比如 说 ，Views/Home。 请 注意 当 你 部 站 网 站 
时 必须 保持 这 种 目录 结构 。 

视图 模板 文件 的 扩展 名 也 取决 于 视图 引擎 的 实现 。 对 于 ASPNET MVC 中 的 两 个 预定 义 
的 视图 引擎 来 说 ， 如 果 选 择 ASPX 视图 引擎 ,那么 扩展 名 为 .aspx; 如 果 选 择 Razor 视图 引擎 ， 
则 扩展 名 为 .cshtml( 或 .vbhtml)( 将 在 第 2 章 提 供 更 多 的 相关 内 容 )。 


5. 返回 JSON 内 容 


ASPNET MVC 非常 适合 实现 那些 会 从 Ajax 上 和 下文 的 jQuery 代码 片段 中 回调 的 简单 Web 
服务 。 你 只 需要 设置 一 个 或 多 个 操作 方法 ， 以 返回 JSON 字符 串 而 不 是 HTML。 下 面 有 一 个 


示例 : 

public JsonResult GetCustomers () 

{ 
// Grab some data to return 
VaT Customers = CustomerRepository.GetAll (); 
/:/ Serialize to JSON and return 
return Json(customers)}).;} 

} 


Json 帮助 器 方法 可 以 获取 一 个 普通 的 NET 对 象 , 并 使 用 内 置 的 JavaScriptSerializer 类 将 
它 序列 化 为 字符 串 。 


注意 : 

如 果 控 制 器 操作 方法 不 返回 ActionResult 呢 ? 首先 且 最 重要 的 前 提 是 ， 没 有 抛 出 异 第 。 
简单 地 说 ，ASPNET MVC 会 将 任何 从 操作 方法 返回 的 值 (数字 、 字 符 串 或 自 定 义 对 象 ) 封 装 成 
一 个 ContentResult 对 象 。ContentResult 对 锡 的 执行 会 导致 浏览 器 oe 列 化 . 例如 ， 一 个 
返回 整数 或 字符 串 的 操作 会 使 你 得 到 一 个 照 原样 显示 数据 的 浏览 器 页 面 。 返 回 自 定义 对 象 却 

会 显示 由 该 对 象 的 ToString 方法 的 执行 所 产生 的 任何 字符 串 。 如 果 该 方法 返回 HIML 字符 串 ， 
那么 没有 任何 标记 会 自动 编码 ， 浏 览 跨 也 不 可 能 正确 地 解析 它 。 了 最 后 ， 空 自 返 回 值 实际 上 是 
被 映射 到 了 EmptyResult 对 和 象 ， 而 它 的 执行 不 会 触发 任何 操作 。 
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控制 器 内 的 异步 操作 

控制 器 的 主要 目的 是 服务 于 用 户 界 面 的 需要 。 需 要 执行 的 任何 服务 器 端 困 数 都 要 映射 到 
一 个 控制 器 方 法 并 从 用 户 界 面 触发 。 执 行 完 目 己 的 任务 后 , 控制 器 方法 会 选择 下 一 个 视图 、 
封 小 一 些 数 据 并 指示 数据 的 所 交 。 

这 是 控制 器 行为 的 本 质 。 然 而 ， 控 制 器 中 的 其 他 特征 也 往往 是 必要 的 ， 尤 其 是 当 控 制 器 
应 用 于 大 而 复 茶 且 带 有 特别 需求 的 新 型 系统 时 ， 比 如 长 时 间 运 行 的 需求 。 在 ASPNET MVC 
的 早期 版 本 中 ， 你 需要 遵循 特定 的 模式 ， 来 赋予 控制 器 方法 的 异步 行为 。 从 NET Framework 
4.5 开始 ， 就 可 以 得 益 于 新 的 async/await 语言 结构 和 底层 的 NET 机制 了 。 下 面 是 用 一 个 或 多 
个 异步 方法 来 编写 一 个 控制 器 类 的 示例 : 

public class HomeController : AsyncController 


{ 
public async Task<ActionResult> Rss () 
{ 
// Run the potentially lengthy operation 
Var client = new HttpClient (); 
Var rss = awalt client.GetSstringAsync (someRssUr1); 


// Parse RSS and bulild the view model 
Var model = new HomelIndexModel (); 
model.News = ParseRsslInternal (rss); 
return model,; 


} 


该 代码 像 是 编写 来 用 以 同步 运行 的 一 一 你 不 必 关 心 回调 问题 。 不 过 最 终 ， 它 非常 具有 可 


读 性 并 且 以 异步 方式 运行 ,这 都 得 荔 于 在 你 使 用 async/await 关键 字 时 ，C# 编 译 吉 添加 的 语法 
糖分 


1.3 本章 小 结 


控制 器 是 ASPNET MVC 应 用 程序 的 核心 。 它 在 用 户 请 求 与 服务 器 系统 功能 之 间 扮 演 媒 
介 的 角色 。 控 制 器 与 用 户 界 面 操作 连接 ， 并 与 中 则 层 保持 联系 。 控 制 器 会 安排 页 面 的 呈现 ， 
但 其 自身 并 不 运行 任何 呈现 方面 的 任务 。 这 是 与 ASPNET Web Forms 的 一 个 主要 区 别 。 在 控 
制 器 中 ， 请 求 的 处 理 与 显示 是 完全 分 开 的 。 而 在 Web Forms 中 ， 页 面 处 理 阶段 却 集 成 了 某 些 
任务 的 执行 与 啊 应 的 呈现 。 

虽然 是 基于 不 同 的 语法 , 但 控制 器 方法 与 ASPNET Web Forms 中 的 回 传 事件 处 理 程序 并 
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没有 太 多 不 同 之 处 。 在 这 方面 ， 控 制 右 类 扮演 着 与 Web Forms 中 代码 隐藏 类 相同 的 角色 。 控 
制 刁 以 及 Web Forms 代码 隐藏 关 都 归属 于 表现 层 。 为 此 ， 你 劳 必要 关注 如 何 对 各 种 不 同 操作 
方法 的 行为 进行 编码 。 请 记 住 ， 在 ASPNET MVC 中 ， 解 决 方案 建筑 中 的 任何 分 层 都 取决 
于 你 。 

本 昔 跳 过 了 在 控制 奋 方 法 中 添加 行为 的 所 有 细节 。 重 点 关注 在 这 之 前 部 分 和 之 后 部 分 的 
内 容 概述 。 在 第 2 章 中 ， 将 深入 到 其 后 的 部 分 ， 因 此 重点 将 会 是 视图 、 视 图 引擎 和 标记 的 生 
成 。 然 后 在 第 3 草 中 ， 会 探讨 模型 绑 定 以 及 在 操作 方法 的 特性 发 挥 作用 之 前 所 及 生 的 事情 。 
在 第 7 章 ， 将 重新 问 到 本 草 的 主题 ， 针 对 如 何在 控制 部 类 中 构造 方法 这 一 问题 ， 做 一 些 设计 
上 的 装 量 。 

我 们 刚刚 只 是 通过 了 控制 器 的 第 一 道 关口 。 还 有 很 多 需要 讲解 和 学 习 的 内 容 。 
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设计 并 非 外 观 怎样 ， 感 觉 如 何 。 设 计 是 (解决 ) 如 何 工作 的 问题 。 
——Steve Jobs 


在 ASPNET MVC 中 ， 任 何 请 求 都 是 通过 一 些 控制 器 上 正在 执行 的 操作 来 处 理 的 。 这 一 
点 甚至 对 于 初学 者 来 说 也 是 比较 容易 理解 的 。 但 是 ， 请 求 又 有 着 初学 者 通常 难以 把 握 的 另 一 
面 一 一 生成 用 于 浏览 器 的 HTML。 

在 ASPNET Web Forms 中 ， 你 甚至 不 会 去 考虑 操作 的 事情 一 一 你 考虑 的 是 一 个 页 面 ， 而 
一 个 页 面 会 同时 包含 逻辑 和 视图 。 在 经 典 的 ASPNET 中 ， 我们 假设 首先 要 制作 一 个 
register.aspx 贝 甸 ， 用 尸 可 以 点 击 -个 链接 访问 到 该 页 面 。 该 页 面 会 展开 它 的 用 户 界面 ， 其 界 
面 结尾 处 是 一 个 提交 按钮 。 该 按钮 会 引发 一 个 POST 并 提交 给 负责 处 理发 送 数 据 的 页 面 ， 将 
应 用 程序 调整 到 适当 的 状态 ， 并 准备 预期 的 感谢 页 面 。 整 个 过 程 都 源 于 该 页 面 的 资源 。 

然而 , 在 ASPNETMVC 中 ， 你 要 将 注册 操作 设置 在 一 些 控制 器 类 上 。 当 通过 GET 命令 
调用 该 操作 时 ， 用 于 数据 输入 的 用 户 界 面 就 会 显示 出 来 。 在 通过 POST 进行 调用 时 ， 该 操作 
会 执行 所 需 的 服务 器 端 任务 ， 然 后 设法 处 理 并 返回 感谢 界面 。 整 个 工作 流程 类 似 于 在 非 网 络 
环境 中 人 处理 的 过 程 。 

在 ASPNET MVC 中 ， 你 只 需要 处 理 两 种 主要 类 型 的 组 件 。 一 种 是 控制 器 ， 它 负责 执行 
请 求 并 为 原始 输入 生成 原始 结果 。 另 一 种 是 视图 引擎 ， 它 负责 生成 基于 由 控制 器 计算 出 的 结 


果 的 任何 预期 的 HIML 啊 应 。 在 这 一 章 中 ,首先 我 会 简要 地 论述 视图 引擎 的 内 部 结构 ， 然 后 
对 如 何 为 引擎 提供 视图 模板 和 数据 做 一 些 实际 的 考量 。 
注意 : 


正如 在 第 1 章 “ASPNET MVC 控制 器 ”中 所 揭示 的 那样 ， 控 制 器 操作 不 一 定 非得 生成 
一 些 HTML。 可 以 把 ASPNETMVC 应 用 程序 看 作 是 能 够 服务 于 各 种 响应 的 组 件 集合 ， 这 些 
响应 包括 HTML、JavaScript、JavaScript 对 象 标志 (JSON) 和 纯 文本 。 在 这 一 章 中 ， 我 会 将 讲 
解 内 容 限 制 在 负责 生成 HTML 的 子 系统 上 。 本 书 的 后 续 内 容 会 详 述 其 他 类 型 的 响应 。 
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2.1 视图 引 黎 的 结构 与 性 能 


视图 引擎 是 为 浏览 器 实际 生成 HTML 输出 的 组 件 。 视 图 引擎 负责 为 每 个 请 求 返回 
HTML， 并 且 它 通过 将 视图 模板 和 由 控制 器 传递 进来 的 数据 进行 融合 来 准备 其 输出 。 该 模板 
以 一 种 引擎 专用 的 标记 语言 来 表示 ， 其 数据 在 字典 或 强 类 型 对 象 中 进行 封装 传递 。 图 2-1 显 
示 了 视图 引擎 与 控制 器 协同 工作 的 整体 状况 。 


操作 岩 操作 周 操作 _ 


<html> 
</html> 


图 2-] 控制 右 与 视图 引 警 
2.1.1 视图 引擎 的 机 制 
在 ASPNET MVC 中 , 视图 引擎 只 是 一 个 实现 固定 接口 一 一 IViewEngine 接口 的 类 。 每 个 
应 用 程序 可 以 有 一 个 或 多 个 视图 引擎 。 在 ASPNET MVC 5 中 ， 每 个 应 用 程序 默认 配备 两 个 
视图 引擎 。 接 下 来 让 我 们 进行 更 详细 的 了 解 。 


1. 检测 已 注册 的 视图 引擎 


直到 ASPNET MVC 4, 首次 创建 ASPNET MVC 应 用 程序 的 时 候 , 微软 Visual Studio 项 
目 癌 导 才 人 允许 你 选择 自己 喜欢 的 视图 引擎 一 ASPX 或 Razor。 图 2-2 显示 了 在 Visual Studio 
2013 中 安装 ASPNET MVC 5 时 出 现 的 特定 对 话 框 。 

如 你 所 见 ， 没 有 ASPX 和 Razor 之 间 的 选项 ， 且 所 有 视图 文件 都 会 使 用 Razor 标记 语言 
来 自动 创建 。 除 了 外 观 ， 你 在 此 处 所 做 的 选择 对 应 用 程序 的 影响 有 限 。 实 际 上 ， 你 的 选择 只 
会 影响 回 导 为 你 所 创建 的 项 目 文件 内 容 。 默 认 情 况 下 ， 任 何 ASPNET MVC 5 应 用 程序 都 总 
是 会 加 载 两 个 视图 引擎 : Razor 和 ASPX。 
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Cs 二 A project template for craating ASP.NET MVC applications. ASP,NET 
[ee J] ™ ] | MVC allows you to build applications using the Model-View-Controller 
合 一 电 二 architecture, ASPNET MVC includes many features that enable fast, 


Web Forms MVC test-driven developrent for creating applications that use the latest 


Cs standards. 
= = 


Facebook Mobile Learm more 


Add folders and core references for: 
四 | Web Forms [WMVC Web APIl 
Authentication: Indihvidual User Accounts 
加 Add un tests 


Test project name: \WebApplicationl,Tests 


图 2-2 选择 你 喜欢 的 视图 引擎 
ViewEngines 类 是 跟踪 当前 已 安装 引擎 的 系统 资源 库 。 这 个 类 比较 简单 ， 只 公开 了 一 个 
名 为 Engine 的 静态 集合 成 员 。 该 静态 成 员 是 由 这 两 个 默认 引擎 初始 化 的 。 下 面 是 一 个 出 自 访 
类 的 代码 摘录 : 


public static class ViewEngines 


{ 
private static readonly ViewEngineCollection engines = 
new ViewEngineCollection { 
new WebFormViewEngine (), 
new RazorViewEngline () 
} 
public static ViewEngineCollection Engines 
{ 
get { return engines; } 
} 
} 


假如 你 对 使 用 ViewEngines Engines 以 编程 方式 检测 已 安装 引擎 感 》 
作 原 理 : 


面 显 示 了 其 工 


private static IList<String> GetReglisteredViewEngines () 
{ 
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return ViewEngines 
.Engines 
.Select (engine => engine.Tostring()) 
.ToL1lst({})-; 


最 可 能 面临 使 用 ViewEngines.Engines 的 情况 是 当 你 需要 这 加 一 个 新 的 视图 引擎 或 和 即 载 
现 有 视图 引擎 的 时 候 。 这 需要 在 应 用 程序 局 动 时 进行 ， 更 准确 地 说 ， 是 在 global.asax 里 的 
Application Start 事件 中 。 


2. 解构 视图 引擎 


视图 引擎 是 一 个 实现 IViewEngine 接口 的 类 。 该 接口 的 协议 表明 其 与 引擎 预期 会 提供 的 
所 有 服务 有 关 : 引擎 会 以 ASPNET MVC 基础 架构 的 名 义 负责 检索 (部 分 ) 视 图 对 象 。 视 图 对 
象 代表 了 在 ASPNET MVC 中 构建 实际 HTML 响应 所 需 的 所 有 信息 的 容器 。 下 面 是 其 接口 
成 员 : 


public interface IViewEngine 
{ 
ViewEngineResult FindPartialView! 
ControllerContext controllercCcontext, 
String partialViewName, 
Boolean useCache).;} 
ViewEngineResult FindView ( 
ControllerContext controllerCcontext, 
String viewName, 
string masterName, 
Boolean useCache).;} 
Vol1d ReleaseView ( 
ControllerContext controllercCcontext, 
IView Vvliew); 


} 
表 2-1 描述 了 IViewEngine 接口 中 方法 的 作用 。 


表 2-1 1IViewEngine 接口 的 方法 


万 法 摘 ” 述 
FindPartial View 创建 并 返回 一 个 表示 一 段 HIML 代码 的 视图 对 银 
FindView 创建 并 返回 一 个 表示 一 个 HTML 页 面 的 视图 对 象 
Release View 释放 指定 的 视图 对 象 
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FindPartialView 和 FindView 都 会 返回 一 个 ViewEngineResult 对 象 , 它 表示 了 在 服务 器 日 
录 树 周围 找 出 一 个 用 于 视图 的 模板 并 将 该 模板 实例 化 的 结果 。 以 下 内 容 是 该 类 的 签名 : 


public class ViewEngineResult 


{ 


// Members 
public IEnumerable<SsString> SearchedLocations { get; private set; } 
public IView View { get; private set; } 
public IViewEngine ViewEngine { get; private set; } 
} 
ViewEngineResult 类 型 只 聚合 了 三 个 元 素 : 视图 对 象 、 用 于 创建 视图 对 象 的 视图 引擎 对 
象 ， 以 及 搜索 到 的 用 来 查找 视图 模板 的 位 置 列表 。SearchedLocations 属性 的 内 容 取决 于 所 选 
视图 引擎 的 结构 和 性 能 。ReleaseView 方法 有 由 在 释放 视图 对 象 已 经 使 用 过 的 所 有 引用 。 
3. 视图 引擎 的 调用 方 是 谁 
虽然 图 2-1 似乎 显示 出 控制 塔 与 视图 引擎 之 间 有 直接 联系 ， 但 这 两 个 组 成 部 分 从 不 直接 
通信 。 相 反 ， 控 制 费 和 视图 引擎 的 活动 都 由 一 个 外 部 的 管理 嚣 对象 ( 操 作 调 用 程序 ) 进 行 协调 。 
操作 调用 程序 由 负责 处 理 请 求 的 HITP 处 理 程 序 直 接触 用。 操作 调用 程序 主要 做 两 件 事 。 第 
一 ， 执 行 控制 器 的 方法 并 保存 操作 结果 。 第 二 ， 处 理 操 作 结 果 。 图 2-3 给 出 了 一 个 序列 图 。 


调用 方法 View 


(name. master. data) 


i Bs i 
i 大 本 。 国 本 大 本 | 本 本 。 本 本 | 国 本 | 国 本 本 本 国 本 四 村。 四 本 
El ES 


调用 方法 FindView | 
定位 并 创建 
一 个 视图 对 象 


Wm i 


= = ==== 


揭示 请 求 -服务 处 理 过 程 的 序列 图 


i 
Ip 
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让 我 们 思考 一 个 控制 器 方法 的 典型 代码 ， 正 如 你 在 第 1 章 中 所 见 的 。 


public ActionResult Index() 
{ 


// Some significant code here 


// Order rendering of the next view 
return View({(); 


} 


控制 器 类 上 的 View 方法 会 将 几 段 数据 一 起 封装 进 一 个 单独 的 容器 : ViewResult 类 中 。 
其 信息 包括 视图 模板 名 称 ， 该 名 称 对 应 的 视图 就 是 控制 器 已 经 选择 好 的 下 一 个 要 回 用户 显示 
的 视图 。 母 版 视图 名 称 的 数据 可 以 选择 放 进 或 不 放 进 ViewResult 中 。 最 后 ，ViewResult 容器 
还 会 合并 将 在 视图 中 显示 的 计算 得 出 的 数据 。 当 View 方法 未 获得 任何 参数 时 ， 就 像 在 之 前 
所 显示 的 代码 片段 中 那样 的 ， 则 将 提供 默认 值 。ViewResult 对 象 的 实例 会 被 传 回 给 操作 调用 
程序 。 

接 下 来 , 操作 调用 程序 会 在 ViewResult 对 象 上 调用 ExecuteResult 方法 。 该 方法 会 通过 已 
注册 视图 引擎 的 列表 ， 找 到 一 个 可 以 匹配 指定 视图 和 母 版 视图 名 称 的 视图 引擎 。 如 果 没 有 找 
到 ， 则 会 抛 出 一 个 异常 。 和 否则 ， 选 定 的 视图 引擎 会 被 要 求 创建 一 个 基于 所 提供 信息 的 视图 
对 象 

随后 ，ViewResult 对 象 会 命令 视图 将 内 容 呈 现 给 所 提供 的 流 一 一 实际 的 响应 流 。 最 后 ， 
ViewResult 对 象 将 指示 视图 引擎 释放 该 视图 。 


4. 视图 对 象 


视图 对 象 是 实现 IView 接口 的 类 的 实例 。 视 图 对 象 的 唯一 目的 是 编写 一 些 HIML 啊 应 到 
文本 编写 器 。 每 个 视图 都 由 名 称 来 标识 。 视 图 的 名 称 同 时 也 与 茶 些 定义 了 用 于 呈现 HIML 布 
局 的 物理 文件 相关 联 。 视 图 名 称 与 实际 HTML 布局 两 者 之 间 的 关联 由 视图 引擎 负责 处 理 。 

钢 图 的 名 称 古 控制 右 操 作 上 View 方法 应 该 捉 供 的 参数 之 一 。 如 有 果 程 序 员 没 有 显 陈 定义 
这 样 的 参数 ， 则 系统 会 按照 惯例 假定 视图 名 称 与 操作 名 称 相同 (第 1 间 中 介绍 过 , 操作 名 称 未 
必 己 方法 名 称 相 匹配 )。 

IView 接口 如 下 所 示 : 

public interface IView 

{ 


Vold Render (ViewContext viewContext, TextWriter writer); 


} 
从 内 部 来 看 ， 视 图 对 象 是 一 个 封装 器 ， 它 封装 了 对 没有 数据 的 可 视 化 布局 进行 描述 的 对 
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象 。 视 图 呈现 意味 着 以 数据 填充 布局 并 将 其 以 HIML 的 形式 呈现 给 某 些 流 。 在 ASPNETMVC 
中 ,两 个 默认 视图 引擎 中 的 ASPX 视图 引擎 一 一 仅 使 用 ASPNET Page 派生 类 来 表示 可 视 化 布 
局 。 另 一 个 视图 引擎 一 Razor 引 敬 一 一 则 是 建立 在 围绕 同一 核心 理念 设计 的 不 同类 的 基础 上 
的 。Razor 引擎 使 用 了 与 ASPNET Page 类 对 应 的 WebMatrix”。 


2.1.2 ”视图 模板 定义 


在 ASPNET MVC 中 ， 显 示 给 用 户 的 一 切 内 容 都 由 视图 所 产生 ， 并 且 依据 模板 文件 进行 
描述 。 之 后 图 形 布 局 会 转化 为 HTML， 并 通过 一 个 或 多 个 级 联 样式 表 (CSS) 文 件 设置 样式 。 
但 是 模板 文件 的 写法 却 取决 于 视图 引擎 。 每 个 视图 引擎 都 有 其 自 有 的 定义 模板 的 标记 语言 
也 有 将 视图 名 称 解析 到 模板 文件 的 规则 集 。 


1. 模板 解析 


在 任务 处 理 结束 时 ， 控 制 絮 要 找 出 呈现 给 用 户 的 下 一 个 视图 的 名 称 。 但 是 视图 名 称 必须 
转化 为 一 些 合适 的 HTML 标记 。 这 需要 额外 的 几 个 步骤 。 首 先 ， 系 统 需要 确定 哪个 视图 引擎 
(如 果 有 的 话 ) 可 以 成 功 处 理 该 视图 的 请 求 。 其 次 ， 视 图 名 称 必 须 匹 配 到 一 个 HTML 布局 ， 并 
基于 该 布局 成 功 地 创建 一 个 视图 对 象 。 

从 获知 视图 名 称 时 开始 , ViewResult 对 象 (在 前 面 的 图 2-3 中 所 示 ) 就 会 按照 视图 引擎 出 现 
在 ViewEngines.Engines 集合 中 的 顺序 ， 对 所 有 已 安装 的 视图 引擎 进行 查询。 每 个 视图 引擎 都 
会 被 检索 以 确定 其 是 否 有 能 力 呈 现 一 个 给 定名 称 的 视图 。 

按照 惯例 ， 每 个 ASPNET MVC 视图 引擎 都 使 用 它们 目 己 的 算法 将 视图 名 称 转化 成 引用 
最 终 HTML 标记 的 资源 名 称 。 对 于 两 个 预定 义 的 视图 引擎 ， 搜 索 算法 会 尝试 将 视图 名 称 与 位 
于 固定 磁盘 路 径 中 的 一 个 物理 文件 进行 匹配 。 

不 过 ， 目 定义 视图 引擎 可 以 摆脱 这 些 限 制 并 采用 一 组 不 同 的 规则 。 例 如 ， 它 可 以 从 数据 
库 中 加 载 视图 布局 ， 或 者 它 可 以 使 用 一 组 日 定义 的 文件 夹 。 


2. 默认 规则 和 文件 夹 


ASPX 和 Razor 视图 引擎 使 用 相同 的 核心 规则 来 解析 视图 名 称 。 两 者 都 会 将 视图 名 称 与 
文件 名 称 相 匹配 ， 并 且 两 者 部 期 望 在 同一 组 预定 义 文件 夹 中 找到 这 些 文 件 。ASPX 和 Razor 
的 唯一 区 别 在 于 包含 视图 布局 的 文件 的 扩展 名 。 


OO 微软 WebMatrix 是 一 个 全 新 的 Web 开发 平台 。 区 别 于 现 有 的 开发 平台 ，WebMatrix 的 特点 是 一 站 式 
和 简化 的 开发 过 程 , 您 只 需要 花 几 个 小 时 便 可 学 会 使 用 WebMatrix、 CSS、HIML、HIML5、ASPNET、 SQIL.、 
数据 库 等 知识 以 及 如 何 编 写 简单 的 Web 应 用 程序 。 这 个 工具 可 以 免费 使 用 ， 提 供 了 核心 代码 和 数据 库 支 持 ， 
集成 了 一 个 开元 Web 应 用 程序 库 ， 以 及 可 以 直接 发 布 /部 普 站 点 的 蝇 大 工具 。 与 庞大 的 Visual Studio 或 
Visual Web Developer 相 比 ，WebMatrix 体积 只 有 1SMB 而 已 ， 开 发 人 员 可 以 很 快速 地 开始 ASPNET、PHP 
站 点 的 开 有 友和 及 布 。 
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除非 你 安装 了 自 定义 视图 引擎 ， 否 则 ASPNET MVC 应 用 程序 会 在 View 文件 夹 中 查找 
其 视图 模板 。 从 图 2-4 中 可 以 看 出 ，View 文件 夹 包含 很 多 子 文件 夹 ， 每 个 都 以 一 个 现 有 的 控 
制 器 名 称 命名 。 最 后 ， 控 制 器 文件 夹 包 含 了 其 名 称 预 期 会 蕊 配 视图 名 称 的 物理 文件 ， 同 时 它 
的 扩展 名 必须 是 可 用 于 ASPX 视图 引擎 的 .aspx 和 可 用 于 Razor 视图 引擎 的 .cshtml( 如 果 在 微 
软 Visual Basic 中 编写 ASPNET MVC 应 用 程序 ， 则 扩展 名 是 .vbhtml)。 


solution Explorer 
各 | 日 - 届 加 得 | 由 
search Solution Explorer (Ctrl+ 名 


加 BasicApp 

PP properties 

nm References 

别 App_Data 

别 App Start 

咽 Content 

面 Controllers 

别 img 

上 Models 

上 Scripts 

| Views 

站 居 ] Account 
[&] _Changepasswordpartial.cshtmml 
[8] _ExternalLoginsListPartial.cshtml 
[8] RemoveAccountPartial.cshtml 
[a8] SetPasswordPartial.cshtml 
[8] ExternalLoginConfirmation.cshtml 
[8] ExternalLoginFailure.cshtml 
[8] Login.cshtml 
[8&] Manage.cshtml 
[®] Register.cshtml 

4 天 | Home 
[®] About.cshtml 
[&] Contact.cshtml 
[@ Index.cshtml 

b 上 别 Shared 

[@] ViewStart.cshtml 


solution Explorer EE: 二 症 二 


图 2-4 在 ASPNETMVC 应 用 程序 中 定位 视图 模板 
虽然 图 2-4 只 列 出 了 .cshtml 的 Razor 视图 文件 , 但 也 支持 你 混合 和 匹配 按照 不 同 语法 所 
写成 的 模板 文件 。 


重要 提示 : 

使 用 不 同 的 标记 语言 编写 视图 模板 当然 不 会 提高 源 代码 的 一 致 性 ， 但 如 果 团 队 的 成 员 各 
自 拥有 的 技能 不 同 ， 或 者 当 你 需要 合并 一 些 送 留 代 码 的 时 候 ， 这 就 成 为 了 一 个 可 行 的 解决 方 
条。 另外 ， 如 果 有 针对 不 同 引 学 的 视图 模板 ， 解 析 名 称 是 可 以 获得 一 些 惊喜 的 。 视 图 引擎 的 
调用 会 依照 它们 的 注册 顺序 ， 并 且 在 默认 情况 下 ，ASPX 引 攻 会 优先 于 Razor 引 等 。 老 要 修 
改 这 一 顺序 ， 需 要 在 应 用 程序 局 动 时 清除 引 竺 集合， 再 重新 按 你 喜欢 的 顺序 添加 引 营 。 
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一 般 情 况 下 ，ASPNET MVC 要 求 你 将 每 个 视图 模板 放 在 使 用 该 模版 的 控制 器 的 文件 夹 
中 。 如 果 预 期 多 个 控制 器 会 调用 同一 个 视图 (或 同一 视图 的 一 部 分 )， 那 么 可 以 把 模板 文件 移 
到 Shared 文件 夹 中 。 

最 后 ， 请 注意 在 Views 文件 夹 中 ， 在 项 目 级 别 上 存在 的 同一 目录 层次 结构 必须 复制 到 生 
产 服务 器 上 。 不 过 ， 像 Controller、App Start 和 ViewModel 这 样 的 文件 夹 却 是 普通 的 名 称 空 
间 容 器 ， 用 于 蝎 好 地 组 织 源 文件 ， 所 以 可 以 在 生产 环境 中 急 略 挥 。 


3. 用 于 视图 的 模板 


如 前 所 述 , 视图 无 非 是 用 来 生成 HIML 内 容 的 模板 。 以 下 是 需要 在 一 些 Views 子 文件 夹 
中 找到 的 一 个 视图 模板 文件 的 有 效 内 容 。 该 视图 模板 面向 的 是 ASPX 视图 引擎 。 
<$s@ Page Language="C#" 


MasterPageFile="~/Views/Shared/site.Master" 
Inherits="System.Web.Mvc.ViewPage™ $> 


<asp:Content ID="aboutTitle"™" ContentPlaceHolderID="TitleContent" 
runat="server"> 
About the book 
</asp:Content> 


<asp:Content ID="aboutContent" ContentPlaceHolderID="MainContent" 
runat="server"> 
<h2><$: ViewBag.Message $></h2> 
wr 
Put content here. 
</p> 

</asp:Content> 

直截了当 地 说 ， 这 看 起 来 与 过 去 可 靠 的 ASPNET Web Forms 页 面 没什么 两 样 。 那 么 
ASPNET MVC 的 关键 在 哪里 ? 

无 可 否认 ， 这 里 你 看 到 的 语法 与 ASPNET Web Forms 页 面 中 的 确实 一 样 ; 但 是 此 文件 的 
角色 却 是 完全 不 同 的 。 在 ASPNET MVC 中 ， about.aspx 不 是 公共 资源 ， 因 此 不 可 以 通过 链接 
或 在 浏览 器 的 地 址 栏 中 输入 而 回 其 发 出 请 求 。 相 反 ， 它 是 一 个 内 部 资源 文件 ， 用 于 为 视图 提 
供 模板 。 尤 其 是 只 有 当 用 户 发 出 一 个 将 系统 映射 到 控制 右 方 法 的 请 求 时 ，about.aspx 模板 才 
会 秘 调 用， 之 后 ， 该 控制 右 方 法 会 选择 About 视图 并 将 其 显示 出 来 ， 如 下 所 示 : 

public ActionResult About () 

{ 


ViewBag.Message = "Thank You for choosing this book!™"; 
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// By default, the view name 1s the same as the actlon name. 
return View(): 


} 


男 一 个 较 大 的 差别 是 通过 该 模板 所 显示 的 数据 。 在 Web Forms 中 ， 每 个 页 面 都 由 几 个 服 
务 器 控件 组 成 ， 而 作为 开发 人 员 ， 你 要 在 服务 器 控件 上 设置 属性 以 显示 数据 。 在 ASPNET 
MVC 中 ， 你 把 需要 传递 到 视图 的 数据 在 一 个 容 堪 对 象 中 进行 分 组 ， 再 将 该 容器 对 象 作 为 选 
择 了 该 视图 的 控制 器 调用 中 的 参数 进行 传递 。 

ASPNET MVC 使 你 能 够 在 对 View 方法 的 调用 中 直接 传递 容器 对 象 。 在 任何 情况 下 ， 都 
有 两 个 预定 义 的 字典 可 用 于 控制 器 方法 填充 数据 .它们 分 别 是 ViewData 字典 和 ViewBag 字典 。 

需要 记 住 的 是 ， 在 理想 情况 下 ， 视 图 对 象 不 需要 自行 检索 数据 ， 它 必须 处 理 的 唯一 数据 
只 是 从 控制 器 所 接收 的 数据 。 


重要 提示 : 

视图 模板 的 目的 是 为 了 生成 HTMIL， 但 模板 的 源 并 不 需要 是 HTML。 用 来 编写 模板 的 语 
言 取决 于 视图 引擎 。 如 果 选 择 ASPX 视图 引擎 ,那么 其 语言 可 能 与 你 从 ASPNET Web Forms 
所 掌握 的 ASPX 标记 差不多 一 样 ; 如 果 选 择 Razor 引 营 或 其 他 引 敬 ， 则 情况 会 大 不 一 样 。 


4. 母 版 视图 


与 在 ASPNET Web Forms 中 一 样 , 你 要 决定 是 从 头 开始 编写 视图 模板 还 是 从 母 版 视图 中 
继承 一 些 常 用 的 标记 。 如 果 选 择 后 者 ， 则 需要 通过 视图 引擎 定义 有 关 语 法 和 约束 设置 的 母 版 

指定 母 版 视图 是 比较 容易 的 。 可 以 使 用 视图 引擎 所 文 持 的 规则 ， 也 可 以 在 从 控制 问 中 选 
择 下 一 个 视图 时 将 母 版 视图 的 名 称 作为 参数 传递 给 View 方法 。 请 注意 与 普通 视图 相 比 ， 母 
版 模板 可 能 会 遵循 不 同 的 规则 。 比 如 ，ASPX 视图 引擎 要 求 母 版 模板 的 扩展 名 为 .master， 且 
需要 放 在 Shared 文件 夹 中 。 而 Razor 视图 引擎 则 要 求 添加 .cshtml 扩展 名 ， 并 需要 你 在 Views 
文件 夹 根 目录 下 的 一 个 专用 的 viewstart.cshtml 文件 中 指定 路 径 。 

后 面 还 会 谈 到 这 两 个 默认 的 视图 引擎 。 


2.2 HTML 帮助 希 


无 可 否认 ，ASPX 视图 引擎 与 ASPNET Web Forms 非常 相似 ， 但 两 者 支持 服务 器 控件 的 
方式 却 不 尽 相 同 。 这 并 非 局 部 实现 所 造成 的 ， 而 是 有 着 更 深层 次 的 原因 。 实 际 上 ， 服 务 器 控 
件 与 Web Forms 页 面 的 生命 周期 耦合 得 过 于 紧密 , 以 至 于 不 能 在 请 求 -处 理 模 式 中 得 到 相对 容 
易 的 改造 ， 该 请 求 处 理 模 式 会 把 操作 分 成 清晰 的 不 同 阶段 ， 如 获取 输入 数据 、 处 理 请 求 、 选 
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择 下 一 个 视图 等 。 
另 一 方面 ， 服 务 器 控件 在 ASPNET 中 提供 了 一 个 非常 重要 的 用 途 一 一 促进 HTML 级 别 
的 代码 重用 。 虽 然 ASPNET MVC 非常 强调 让 开发 人 员 获 得 对 每 一 个 HTML 标记 的 控制 , 但 
很 多 HTML 却 不 能 在 视图 中 硬 编 码 。 它 们 需要 根据 动态 发 现 的 数据 以 编程 方式 进行 构建 。 在 
ASPNET MVC 中 等 同 于 服务 器 控件 的 技术 是 什么 ? 答案 就 是 HIML 帮助 器 。 


注意 : 

HTML 帮助 器 与 服务 器 控件 当然 不 是 一 回 事 , 但 其 是 在 用 视图 引擎 获得 HTML 级 代码 重 
用 方面 最 接近 于 服务 器 控件 的 。HTML 帮助 器 方法 没有 视图 状态 、 没 有 回 传 、 也 没有 页 面 生 
命 周 期 和 事件 。HTML 帮助 器 就 是 简单 的 HIML 工厂 .。 从 技术 上 讲 ，HTML 帮助 器 是 在 一 个 
系统 类 一 HtmlHelper 类 上 定义 的 扩展 方法 ， 这 个 类 可 以 在 所 提供 的 输入 数据 的 基础 上 输出 
HTML 字符 串 。 实 际 上 ，HTML 帮助 器 的 内 部 机 制 就 是 将 文本 累加 到 一 个 StringBuilder 对 
象 中 。 


2.2.1 基础 帮助 希 


ASPNET MVC 框架 提供 了 一 些 现成 的 HTML 帮助 器 ， 包 括 CheckBox、ActionLink 和 
RenderPartial。 表 2-2 提供 了 一 组 HIML 帮助 器 的 列表 。 


表 2-2 HTML 帮助 器 方法 集 


万 法 类 型 拍 述 

BeginForm, BeginRouteForm Form 返回 一 个 表示 系统 用 于 呈现 <form> 标 记 的 HIML 格 
i 陈 的 内 部 对 象 

EndForm 一 个 void 方法 ， 关 闭 等 待 的 </form> 标 记 
CheckBox, CheckBoxFor 为 一 个 复 选 框 输入 元 率 返 回 HTML 字符 串 
Hidden, HiddenFor 为 一 个 隐藏 的 输入 元 素 返 回 HTML 字符 串 
Password PasswordFor 为 一 个 密码 输入 元 条 返回 HIML 字符 串 
RadioButton, RadioButtonFor 为 一 个 单 选 按钮 输入 元 系 返 回 HTML 字符 串 
TextBox, TextBoxFor 为 一 个 文本 和 输入 元 系 返 回 HIML 字符 串 


Label, LabelFor Label 为 一 个 HIML 标 例 元 系 返 回 HTML 字符 串 
ActionLink, RouteLink 为 一 个 HIML 链接 返回 HTML 字符 串 
DropDownList, DropDownListF or 为 一 个 下 拉 框 列表 返回 HTML 字符 串 
ListBox, ListBoxFor 为 一 个 列表 框 返回 HIML 字符 串 
TextArea, TextAreaFor 为 一 个 文本 区 域 返 回 HTML 和 字符 串 

Partial 返回 合并 到 指定 用 户 控件 中 的 HTML < 
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( 续 表 ) 


"| 将 合并 到 指定 用 户 控件 中 的 HIML 字符 串 写 入 输出 
流 


ValidationMessage， Validation 为 一 个 验证 消 且 返回 HIML 字符 串 
ValidationMessageFor 
ValidationSummary Validation 为 一 个 验证 摘要 消 明 返回 HIML 字符 串 


举 个 例子 ， 让 我 们 看 看 如 何 使 用 HIML 帮助 喜来 创建 一 个 以 编程 方式 确定 文本 的 文本 
框 。 如 有 果 使 用 ASPX 视图 引擎 ， 则 可 以 在 一 个 代码 块 中 放置 下 面 的 调用 : 


<$: Html .TextBox("TextBoxl", ViewBag.DefaultText) 和 要 > 


或 者 ， 如 果 使 用 Razor 视图 引擎 ， 则 需要 在 该 调用 前 面 添加 @ 符 号 (将 很 快 在 本 书 的 其 他 
部 分 谈 到 Razor)。 


QHtml .TextBox ("TextBoxl", ViewBag.DefaultText) 


注意 : 

该 代码 片段 中 的 Html 涉及 基 类 的 内 置 属性 ， 两 个 视图 引擎 都 会 使 用 它 来 引用 呈现 的 视 
图 。 该 类 对 于 ASPX 视图 引擎 来 说 是 ViewPage， 而 对 于 Razor 视图 引擎 则 是 WebPage。 在 这 
两 种 情况 下 ， 属 性 Html 都 是 HtmlHelper 的 一 个 实例 。 


每 个 HTML 帮助 器 均 有 一 大 堆 重 载 来 让 你 指定 特性 值 和 其 他 相关 信息 。 比 如 ， 以 下 是 如 
何 通过 使 用 类 特性 来 设置 文本 框 的 风格 : 
<$S: HLm .TextBox(" TextBoxl"™, 


ViewBag.DefaultText, 
new Dictionary<Sstring, Object>{{"class", "coolTextBox"™}}) $> 


在 表 2-2 中 你 能 看 到 很 多 形 如 xxxFor 的 帮助 器 。 它 们 与 其 他 帮助 器 相 比 有 哪些 不 同 呢 ? 
一 个 形 如 xxxFer 的 帮助 器 与 基础 版 本 的 不 同 之 处 在 于 它 只 接受 lambda 表达 式 ， 比 如 下 面 的 
这 个 帮助 右 : 

<$S: Html .TextBoxFor (model => model] .FirstName, 

new Dictionary<Sstring, Object>{{"class", "coolTextBox"™} }) $> 

对 于 文本 框 ，lambda 表达 式 会 指出 要 在 输入 字段 中 显示 的 文本 。 当 要 填充 视图 的 数据 在 
一 个 模型 对 象 中 进行 分 组 时 ，xxxFor 变 体 尤 其 有 用 。 在 这 种 情况 下 ， 视 图 结果 的 读 取 会 更 清 
晰 ， 并 且 是 强 类 型 化 的 。 
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让 我 们 看 看 基本 HTML 帮助 器 的 其 他 一 些 例子 。 
1. 呈现 HTML 表单 


在 ASPNET MVC 中 呈现 表单 ， 最 让 人 厌烦 的 事情 是 需要 指定 目标 URL。BeginForm 和 
BeginRouteForm 帮助 器 能 承担 这 一 令 人 不 快 的 工作 。 下 面 的 代码 片段 显示 了 如 何 编写 一 个 呈 
现 用 户 和 密码 文本 框 的 简单 输入 表单 : 


<$ using (Html .BeginForm()) { $> 
<dliv> 
<fieldset> 

<legend>Account Information</legend> 

<p> 
<label for="userName">User name:</label> 
<$= Html .TextBox("userName™") $> 
<$= Html .ValidationMessage ("userName") $> 

</p> 

<p> 
<label for="password">Password:</label> 
< 二 Html .Password ("password") %> 
<$= Html .ValidationMessage ("password") $%> 

</p> 

<p> 
<input type="submit"™" value="Change Password™ /> 

</p> 

</fieldset> 
</dliv> 
< } $> 


BeginForm 帮助 器 人 负责 <form> 开 始 标 记 。 但 BeginForm 方法 并 不 直接 发 出 任何 标记 。 它 
仅 限 于 创建 MvcForm 类 的 实例 ， 该 实例 之 后 会 添加 到 页 面 的 控件 树 并 随后 呈现 。 

默认 情况 下 , BeginForm 会 呈现 一 个 回 发 到 相同 URL 并 随后 回 发 至 相同 控制 器 操作 的 表 
单 。 使 用 BeginForm 方法 的 其 他 重 载 ， 可 以 指定 目标 控制 器 的 名 称 和 操作 、 该 操作 的 任意 路 
由 值 、HTML 特性 ， 甚 至 可 以 指定 是 售 需 要 表单 执行 GET 或 POST 动作 。BeginRouteForm 
的 作用 与 BeginForm 差不多 ， 但 有 一 点 不 同 ， 它 可 以 从 任意 一 组 路 由 参数 开始 而 生成 一 个 
URL。 换 句 话 说，BeginRouteForm 并 不 局 限于 基于 控制 器 名 称 和 操作 的 默认 路 由 。 

我 相信 探讨 HTML 表单 是 展示 Razor 的 附加 值 优 于 ASPX 的 最 佳 方式 .下面 显示 了 如 何 
使 用 Razor 语法 重 写 先前 的 表单 : 


Qusing (Htm1l.BeglnEorm() ) 
{ 
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<dliv> 
<fieldset> 
<legend>Account Information</legend> 
<p> 
<label for="userName">User name:</label> 
QHtml .TextBox ("userName™") 
QHtml .ValidationMessage ("userName") 
</p> 
<p> 
<label for="password">Password:</label> 
QHtm]l .Password ("password") 
QHtml .ValidationMessage ("password") 
</p> 
<p> 
<input type="submit"™ value="Change Password™ /> 
</p> 
</fieldset> 
</d1lv> 
} 


本 书 的 其 余部 分 都 会 将 Razor 用 于 视图 。 


注意 : 

在 HTML 中 ， 当 你 使 用 表单 标记 时 ， 只 能 使 用 GET 和 POST 动词 提交 一 些 内 容 。 而 在 
ASPNET MVC 中 ，HtmlHelper 类 上 的 一 个 原生 方法 一 一 HttpMethodOverride 一 一 解决 了 这 个 
问题 。 该 方法 会 发 出 一 个 隐藏 字段 ， 其 名 称 硬 编码 到 X-HTTP-Method-Override， 并 且 其 值 是 
PUT、DELETE 或 HEAD。 该 隐藏 字段 的 内 容 会 重 载 表单 的 方法 和 集 ， 因 此 你 也 能 够 从 浏览 器 
的 内 部 调用 RESTAPI 了 。 你 还 可 以 用 相同 的 X-HTTP-Method-Override 名 称 指定 HTTP 标 头 
中 的 重 载 值 ， 或 者 将 查询 字符 串 值 中 的 重 载 值 指定 为 名 称 / 值 对 。 重 载 只 对 POST 请 求 有 效 。 

2. 呈现 输入 元 素 

你 能 在 表单 中 使 用 的 所 有 HTML 元 系 都 有 一 个 HTML 帮助 需 来 加 速 开 友 。 上 再 次 说 明 一 
下 ， 从 功能 的 角度 来 看 使 用 帮助 器 与 使 用 普通 的 HIML 之 间 并 无 差别 。 下面 是 一 个 复 选 框 元 
素 的 示例 ， 初 始 设置 为 true 但 禁用 : 


@Html .CheckBox ("ProductDiscontinued"™, 
true, 
new Dictionary<string, Object>() {{"disabled", "disabled"}})) 


你 还 拥有 将 验证 消息 与 输入 字段 相关 联 的 工具 。 如 果 指 定 的 字段 中 包含 错误 ， 则 可 以 使 
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用 Html.ValidationMessage 帮助 器 来 显示 验证 消息 。 该 消息 可 以 通过 帮助 器 中 的 一 个 附加 参数 
显 式 指示 出 来 .所 有 的 验证 消息 之 后 会 通过 Html.ValidationSummary 帮助 器 聚合 与 显示 出 来 。 
你 会 在 第 4 草 “ 输 入 表单 ”中 看 到 对 输入 表单 和 验证 的 进一步 探讨 。 


3. 操作 链接 


如 前 文 所 述 ， 以 编程 方式 创建 URL 是 ASPNET MVC 中 一 个 乏味 且 易 出 错 的 任务 。 因 此 
帮助 器 大 受 欢 迎 ， 特 别 是 针对 这 种 任务 。 事 实 上 ，ActionLink 帮助 器 是 ASPNET MVC 视图 
中 最 常用 到 的 一 个 。 下 面 是 一 个 示例 : 


QHtml .ActionLink ("Home™"™, "Index™, "Home™) 


通常 情况 下 ， 操 作 和 链接 需 要 链接 文本 、 操 作 名 称 和 可 选 的 控制 嚣 名称。 该 示例 产生 的 
HTML 如 下 : 


<Aa href="/Home/Index">Home</ay> 


此 外 ， 可 以 指定 路 由 值 、 锁 点 标记 的 HTML 特性 、 甚 至 是 一 个 协议 (比如 HITPS)、 主 机 
和 片段 。 

RouteLink 帮助 器 的 工作 方式 差不多 相同 ， 但 它 不 需要 你 来 指定 操作 。 有 了 RouteLink 
帮助 右 ， 束 可 以 使 用 任何 已 注册 的 路 由 名 称 来 确定 生成 的 URL 的 模式 了 。 

由 ActionLink 发 出 的 文本 会 进行 自动 编码 。 这 就 是 说 你 不 能 在 链接 文本 中 使 用 任何 可 能 
叶 致 浏览 器 将 其 看 作 HTML 的 HTML 标记 。 尤 其 不 能 把 ActionLink 用 作 视 图 按钮 和 图 像 链 
接 。 不 过 ， 各 要 生成 基于 控制 器 和 操作 数据 的 链接 ， 则 可 以 使 用 UrlHelper 类 。 

UrlHelper 类 的 实例 与 ViewPage 类 型 上 的 Url 属性 相关 联 。 下 面 的 代码 显示 了 实际 使 用 
中 的 Url 对 象 : 

<a href="Q@Url1 .Action ("Edit"}) "> 

<1img src="editMemo.Jpg" alt="Edit memo" /> 

</a> 

UrlHelper 类 有 几 个 方法 的 作用 类 似 于 ActionLink 和 RouteLink。 它 们 的 名 称 是 Action 
和 RouteUrl。 


注意 : 

ASPNET MVC 路 由 不 能 识别 子 域 ， 它 总 是 假定 你 处 于 应 用 程序 路 径 之 中 。 这 意味 着 如 
果 想 要 在 单个 应 用 程序 内 使 用 子 域 ， 而 不 是 在 虚拟 路 径 ( 例 如 ， 使 用 dino.blogs.com 而 不 是 
www.blogs.com/dino) 中 ， 那 么 找 出 你 位 于 哪个 子 应 用 程序 的 额外 工作 就 完全 是 你 自己 的 事情 
了 。 有 多 种 方式 可 以 解决 这 个 问题 。 一 个 简单 的 方法 是 创建 一 个 自 定 义 路 由 处 理 程序 ， 由 它 
查看 在 URL 中 传递 的 主机 , 并 决定 设置 哪个 控制 器 。 但 是 这 个 解决 方案 仅 限 于 固定 的 传 入 请 
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求 。 它 可 能 并 不 能 满足 用 于 生成 到 资源 和 操作 的 链接 的 所 有 帮助 器 。 一 个 更 完整 的 解决 方案 
是 创建 一 个 能 识别 子 域 的 Route 类 。 可 以 在 http://blog.maartenballiauw.be/post/2009/05/20/ 
ASPNETMVC-Domain-Routing.aspx 找到 一 个 合适 的 例子 。 


4. 部 分 视图 


可 以 使 用 Partial 或 RenderPartial 帮助 器 方法 来 插入 一 个 部 分 视图 。 这 两 种 方法 都 米 用 该 
部 分 视图 的 名 称 作 为 参数 。 两 者 的 唯一 区 别 是 Partial 返回 一 个 字符 串 ， 而 RenderPartial 会 写 
入 到 输出 汰 ， 并 返回 空 。 因 此 ， 两 者 的 用 法 稍 有 不 同 ， 如 下 上 所 示 : 


QHtm]l .Partial ("login"™) 
QHtml .RenderPartial ("login"™) 


在 ASPNET MVC 中 ， 部 分 视图 类 似 于 Web Forms 中 的 用 户 控 件 。 部 分 视图 的 典型 位 置 
位 于 Views 中 的 Shared 文件 夹 。 但 是 也 可 以 将 部 分 视图 存储 在 控制 右 专 用 的 文件 夹 中 。 部 分 
视图 包含 在 视图 中 ， 但 会 被 视 作 完全 独立 的 实体 。 实 际 上 ， 为 一 个 视图 引擎 编写 一 个 视图 而 
该 视图 的 部 分 视图 却 需要 男 一 个 视图 引擎 的 情形 是 完全 合理 的 。 

5. HtmlHelper 类 

HtmlHelper 类 受 欢迎 的 原因 很 大 程度 上 归功 于 其 众多 的 扩展 方法 ， 但 它 也 有 不 少 有 用 的 
原生 方法 。 表 2-3 列 出 了 其 中 的 一 些 。 


表 2-3 HtmlHelper 最 受 欢 迎 的 原生 方法 


万 法 摘 ” 述 

AntiForgeryToken 为 存储 了 防伪 令 脾 的 隐 鼎 输入 字段 返回 HIML 字 从 串 (更 多 评 细 信 
息 请 参见 第 4 章 ) 

AttributeEncode 使 用 HIML 编码 规则 对 指定 特性 值 进行 编码 

FnableUnobtrusiveJavaScript 以 隐 式 方式 设置 多 许 帮 助 右 生成 JavaScript 代码 的 内 部 标识 

EnableClientValidation 设置 允 计 生 助 器 生成 用 于 客户 绩 验 证 的 代码 的 内 部 标识 

Encode 使 用 HTML 编码 规则 对 指定 值 进行 编码 

HttpMethodOverride 为 用 于 重 与 有 效 HTTP 动词 以 表明 所 需 的 PUT 或 DELETE 操作 的 
隐藏 输入 字段 返回 HIML 字符 串 

Raw 返回 未 编 公 的 原 她 HTML 字符 串 


此 外 ，HtmlHelper 类 还 提供 了 大 量 的 公共 方法 ， 这 些 方法 在 视图 内 部 几乎 没有 用 处 ， 却 
为 编写 自 定义 HTML 帮助 器 方法 的 开发 人 员 提 供 了 大 力 支持 。GenerateRouteLink 就 是 一 个 好 
例证 ， 它 会 返回 一 个 包含 指定 路 由 值 虚拟 路 征 的 锚 点 标记 。 
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2.2.2 ”模板 化 帮助 器 

一 遍 所 地 编写 HTML 模板 是 非常 乏味 枯燥 的 ,并且 容易 导致 代码 出 错 。 模 板 化 帮助 需 就 
能 帮 上 大 忙 , 因为 它们 被 创建 来 使 用 C# 张 的 实例 、 读 取 属 性 、 并 决定 如 何 最 好 地 呈现 这 些 值 。 
通过 使 用 特殊 特性 来 设置 视图 模型 对 象 ， 你 便 为 帮助 需 提 供 了 关于 用 户 界 面 提示 和 验证 的 进 
一 步 指示 。 

有 了 模板 化 帮助 器 ， 就 不 会 失去 对 用 户 界 面 的 控制 了 ; 简 言 之 ， 模 型 中 的 特性 建立 起 一 
系列 的 规则 ， 将 你 从 楷 重 的 重复 邦 动 中 解放 了 出 来 。 


1. 模板 化 帮助 右 的 多 种 类 型 


在 ASPNET MVC 中 ,你 有 两 个 基本 的 模板 化 帮助 器 : Editor 和 Display。 它 们 相互 协作 ， 
使 代码 在 标识 、 显 示 和 编辑 数据 对 象 方面 更 易于 编写 和 维护 。 使 用 这 些 帮 助 器 的 最 优 方案 是 
在 带 注 释 的 对 象 附 近 编 写 你 的 列表 或 输入 表单 。 不 过 ， 模 板 化 帮助 器 可 以 同时 作用 于 标量 值 
和 复合 对 象 。 

模板 化 帮助 器 其 实 具有 三 个 重 载 。 以 Display 帮助 器 为 例 ， 它 有 以 下 三 个 更 具体 的 帮助 
#3: Display、 DisplayFor 和 DisplayF orModel, 这 三 者 之 间 并 无 功能 上 的 差异 。 它 们 的 唯一 区 
别 在 于 各 自 能 够 处 理 的 输入 参数 。 


2. Display 帮助 器 

Display 帮助 器 接受 一 个 在 ViewData 字典 中 或 视图 模型 对 象 上 指明 属性 名 称 的 待 处 理 字 
侍 串 : 

QHtml .Display ("FirstName") 

DisplayFor 帮助 器 接受 一 个 lambda 表达 式 ， 并 要 求 把 视图 模型 对 象 传递 给 视图 : 


QHtml .DisplayFor (model => model .FirstName) 

到 后 ，DisplayForModel 是 获取 model => model 表达 式 的 DisplayFor 的 快捷 方式 : 

QHtml .DisplayForModel () 

各 种 类 型 的 模板 化 帮助 器 都 有 处 理 元 数据 (如 果 有 的 话 ) 的 特殊 能 力 ， 并 可 根据 情况 对 其 
呈现 做 相应 的 调整 ， 比 如 显示 标签 和 添加 验证 。 可 以 通过 使 用 模板 自 定义 显示 和 编辑 功能 ， 
这 在 后 面 还 会 谈 到 。 使 用 自 定义 模板 的 能 力 适用 于 所 有 类 型 的 模板 化 帮助 右 。 

重要 提示 : 

ViewBag 是 在 被 定义 为 动态 类 型 的 ControllerBase 类 上 定义 的 属性 。 在 .NET 中 , 动态 类 型 
表示 动态 解释 代码 的 网 站 。 换 句 话 说 ,每 当 编 译 器 满足 了 对 动态 对 象 的 引用 时 ， 它 就 会 发 出 一 
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段 代码 ， 在 运行 时 检查 其 是 否 可 以 解析 和 执行 。 从 功能 上 讲 ， 这 类 似 于 JavaScript 对 象 的 情况 . 
lambda 表达 式 不 支持 动态 成 员 ， 因此 不 能 用 于 将 数据 传递 到 ViewBag 字典 。 另 外 需要 注 
意 的 是 ， 为 了 成 功 使 用 HIML 帮助 器 中 的 ViewBag 内 容 ， 你 必须 将 表达 式 转换 成 有 效 类 型 。 


3. Editor 帮助 希 


Editor 帮助 器 的 目的 是 让 你 编辑 指定 的 值 或 对 象 。 该 编辑 器 会 识别 它 所 获取 的 值 的 类 型 ， 
并 挑选 量 身 定 做 的 模板 进行 编辑 。 预 定义 的 模板 有 用 于 对 象 、 字 符 串 、 布 尔 值 和 多 行文 本 的 ， 
而 数字 、 日 期 和 全 局 统一 标识 符 (GUID) 则 会 退回 到 字符 串 编辑 器 。Editor 帮助 器 极其 擅长 处 
理 复杂 类 型 。 它 通常 会 遍历 每 一 个 公共 属性 ， 并 为 子 值 建立 一 个 标签 和 编辑 器 。 下 面 是 在 纺 
辑 器 中 ， 如 何在 一 些 传递 到 视图 的 对 象 上 显示 FirstName 属性 的 值 : 


QHtml .EditorFor (person => person.FirstName) 


可 以 通过 在 视图 的 EditorTemplates 文件 夹 中 创建 几 个 部 分 视图 来 目 定 义 编辑 器 (和 可 视 
化 工具 )。 它 可 以 位 于 控制 器 专 有 的 子 文件 夹 中 ， 也 可 以 位 于 Views\Shared 文件 夹 中 。 对 于 
ASPX 视图 引擎 ， 部 分 视图 表现 为 一 个 .ascx 模板 ， 而 如 果 正 使 用 Razor 视图 引擎 ， 则 部 分 视 
图 表现 为 一 个 .cshtml 模板 。 可 以 为 每 一 个 所 期 望 文 持 的 类 型 提供 一 个 自 定 义 模板 。 例 如 ， 在 
2-5 中 可 以 看 到 一 个 datetime.cshtml 模板 ， 它 将 用 于 修改 日 期 在 编辑 与 显示 中 的 呈现 方式 。 
同样 地 ， 可 以 为 视图 模型 对 象 中 每 个 类 型 的 属性 提供 一 个 部 分 视图 。 


A 天启 


search :olution Explorer 【tr 二 二 | 


"a References 
面 Commeon 
面 Components 
别 Content 
面 Controllers 
Resources 
面 ViewModels 
屋 | Views 
a | Customer 
a | DisplayTemplates 


刻本 本 本 本 可 本 本 


[@] Boolean.cshtml 
Datetime.cshtrnl 
[@] Object.cshtrml 
[S] Url,cshtml 
b EditorTemplates 
[&] edtt.cshtml 
[8&] index.cshtml 
二 下 | Home 
IE] mdex.cshtml 
b 面 Memo 
b 面 Shared 
[@] WWewstart.cshtml 


门 Web.config 
bp 6 Globalasax 
b 的 Web.config 
Solution Explorer ML Lo = 


图 2-5 用 于 编辑 器 和 可 视 化 工具 的 目 定义 模板 
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如 果 部 分 视图 的 名 称 与 类 型 名 称 相 匹配 ， 则 系统 会 自动 选取 自 定 义 模板 。 
也 可 以 通过 名 称 将 编辑 器 指 癌 你 的 模板 ， 并 为 模板 取 一 个 你 喜欢 的 名 称 。 下 面 是 一 个 使 
用 date ascx 视图 来 编辑 DateTime 属性 的 示例 : 


QHtm] .EditorFor (person => person.Birthdate, "date") 


在 同一 个 ASPNET MVC 应 用 程序 中 ， 可 以 拥有 请 求 不 同 的 视图 引擎 的 视图 。 请 注意 
ASPNET MVC 会 自主 解析 每 一 个 视图 和 部 分 视图 。 这 意味 着 如 果 正 在 运行 ,比如 about 视图 
的 过 程 ， 那 么 该 过 程 会 最 终结 束 于 Razor 引擎 (如 图 2-5 所 示 )。 但 是 ， 如 果 about 视图 需要 一 
个 用 于 日 期 的 编辑 器 而 你 有 一 个 匹配 的 .aspx 模板 , 那么 不 用 你 提供 类 似 的 .cshtml 模板 , about 
视图 也 会 被 选取 出 来 的 。 

最 后 ，Editor 帮助 器 可 以 识别 视图 模型 对 象 上 的 数据 批注 特性 ， 并 使 用 这 些 信息 来 添加 
特殊 的 验证 功能 ， 比 如 确保 给 定 值 落 在 指定 的 范围 内 或 不 为 空 。 


注意 : 

当 你 使 用 DisplayForModel 和 EditorForModel 时 ， 系 统 会 使 用 反射 来 查找 指定 对 象 的 所 
有 属性 ， 然 后 为 每 个 属性 生成 一 个 标签 和 可 视 化 工具 或 者 编辑 器 。 生 成 视图 的 整体 模板 是 标 
签 和 可 视 化 工具 /编辑 器 的 垂直 序列 。 发 出 的 每 个 HTML 段 均 会 绑 定 到 一 个 CSS 类 ， 并 且 可 
以 轻松 地 设置 成 你 豆 欢 的 样式 。 此 外 ， 如 果 想 更 改 视 图 模板 ， 则 需要 提供 一 个 object.aspx( 或 
object.cshtmD) 模 板 ， 还 要 使 用 反射 。 在 第 4 章 中 还 会 谈 到 这 个 问题 ， 并 举 出 相关 示例 . 
2.2.3 ” 目 定 义 帮助 器 

HTML 帮助 器 方法 的 原生 集合 绝对 大 有 神 益 ， 但 它 对 于 许多 实际 的 应 用 程序 可 能 是 不 合 
适 的 。 原 生 帮 助 器 实际 上 只 涵盖 了 基本 的 HTML 元 素 标记 。 在 这 方面 ， HTML 帮助 器 与 服务 
器 控件 显著 不 同 ， 因 为 它们 完全 缺乏 对 HTML 的 抽象 化 。 但 是 HTM 帮助 器 集 的 扩展 却 是 很 
容易 的 。 如 果 有 意 创 建 一 个 处 理 Ajax 任务 的 HTML 工厂 ， 那 么 全 部 所 需 只 是 HtmlHelper 类 
或 AjaxHelper 类 的 一 个 扩展 方法 。 


1. HTML 帮助 兹 的 结构 


HTML 帮助 器 是 一 个 普通 的 方法 ,不 依赖 于 任何 强制 的 原型 模式 。 通 剃 你 要 设计 HTML 
帮助 器 方法 的 签名 ， 使 它 只 接受 需要 的 数据 。 有 几 个 重 载 或 可 选 参数 也 是 常见 现象 。 

从 内 部 来 看 ， 帮助 器 处 理 输入 数据 并 自 先 会 通过 在 缓存 区 累加 文本 来 构建 输出 HIML。 这 
是 最 灵活 的 方法 ， 但 当 应 用 的 逻辑 变 得 复杂 的 时 候 ， 也 是 难于 管理 的 。 男 一 种 方法 包含 使 用 
TagBuilder 类 来 生成 HTML， 该 类 提供 了 面向 HTML 的 字符 串 生成 器 工具 。TagBuilder 类 为 你 
生成 HTML 标记 的 文本 ， 从 而 可 以 使 你 通过 串联 标签 而 非 普 通 的 字符 串 以 构建 大 块 的 HTML。 

HTML 帮助 器 预期 会 返回 一 个 已 编码 的 HIML 字符 串 。 
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2. MvcHtmlString 不 只 是 一 个 字符 串 


如 果 对 一 个 已 编码 的 标记 片段 使 用 紧凑 语法 会 怎么 样 ? 如 果 缺 乏 应 对 措施 ， 文 本 就 会 不 
可 避免 地 被 双重 编码 。 因 此 ， 最 好 的 做 法 是 编写 可 以 返回 MvcHtmlString 封装 对 象 而 非 普 通 
字符 串 的 HTML 帮助 器 。 实 际 上 ， 上 所 有 的 原生 HTML 帮助 器 都 会 被 重 构 以 返回 
MvcHtmlString。 这 一 更 改 对 开 太 人 员 来 说 不 算 什 么 。 通 过 和 下面 的 代码 ， 可 以 很 容易 地 从 一 个 
字符 串 中 获得 MvcHtmlString 对 象 : 


Var html = GenerateHtmlAsSstring(); 
return MvcHtmlstring.Create (html]l); 


MvcHtmlString 类 型 是 对 包含 HTML 内 容 的 字符 串 的 一 个 智能 封装, 它 公开 了 IHtmlString 
接口 。 

IHtmlString 的 目的 是 什么 ?在 ASPNET 中 试图 对 实现 IHtmlString 的 对 象 进行 HTML 编 
人 码 会 造成 空 操作 指令 。 


3. HTML 帮助 希 梓 例 


假定 你 的 视图 接收 了 一 些 可 以 为 空 的 文本 。 不 过 你 并 不 想 呈 现 空 的 字符 串 ; 而 宁愿 显示 
一 些 默认 的 文本 ， 如 N/A。 要 如 何 做 才 行 ? 只 用 一 个 站 语句 就 可 以 完美 地 解决 一 切 。 但 是 在 
ASPX 标记 中 髓 套 站 语句 并 不 会 有 助 于 代码 的 简洁 ;在 Razor 中 情况 也 好 不 到 哪里 去 。 

一 个 专用 帮助 器 可 以 摆平 一 切 , 因为 它 封 滚 了 站 语句 , 并 且 提 供 更 加 紧 竣 和 吻 读 的 代码 ， 
同时 还 保留 了 所 需 的 逻辑 。 下 面 的 代码 演示 了 一 个 HIML 帮助 器 ， 如 有 果 给 定 的 字符 串 为 null 
或 空 的 话 ， 它 会 用 一 些 默 认 文本 葵 换 该 字符 串 : 


public static class OptionalTextHelpers 
{ 
public static MvcHtmlstring OptionalText (this HtmlHelper helper., 
string text, 
String format="{0}", 
String alternateText="", 
string alternateFormat="{0}") 


Var actualText = text: 
Var actualFormat = format; 


1f (String.IsNullorEmpty (actualText)) 
{ 
actualText = alternateText,; 
actualrFormat = alternateFormat,; 
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return MvycHtmlSsString.Create (String.Format (actualFormat, actualText)); 


} 


帮助 器 最 多 可 以 有 四 个 参数 ， 其 中 三 个 为 可 选 参数 。 和 帮助 妖 用 到 了 原始 文本 及 其 null 的 
答 换 ， 另 外 还 有 一 个 格式 化 字符 串 来 修饰 这 两 种 情况 下 的 文本 。 


4. Ajax 帮助 兹 样 例 


Ajax 帮助 器 与 HIML 帮助 器 的 区 别 仅仅 由 于 它 是 在 Ajax 操作 的 上 下 文中 调用 的 。 例 如 ， 
我 们 假设 你 需要 将 某 个 图 片 用 作 按 钮 . 单 击 该 图 片 应 该 自动 触发 对 某 些 应 用 程序 URL 的 Ajax 
调用 。 

那么 这 与 只 是 将 一 些 JavaScript 附加 到 图 片 的 click 事件 然后 使 用 jQuery 进行 调用 有 什么 
不 同 昵 ?如果 知道 传递 到 jQuery 的 URL， 则 不 需要 此 帮助 器 。 但 是 如 果 发 现 将 URL 表达 为 
控制 占 / 操 作对 更 好 的 话 ， 就 需要 这 个 帮助 器 来 生成 一 个 链接 ， 把 用 户 帝 到 控制 器 /操作 对 所 
指向 的 任何 地 方 ， 如 下 所 示 : 


public static Class AjaxHelpers 
{ 
public static String ImgActionLink (this AjaxHelper a]axHelpe， 

String imageUrl, 
String imgAltText, 
string imgstyle, 
string actionName, 
String controllerName, 
Object FrouteValues， 
AjaxOoptions ajaxOptions, 
Object htmlAttributes,) 


const String tag = "[xxx]"; // arbitrary string 

Var markup = ajaxHelper.ActionLink ( 
tag, actionName, controllerName, routeValues, ajaxOptions, 
htmlAttributes) .ToString(); 


// Replace text with IMG markup 
Var urlHelper = new UrlHelper (ajaxHelper. 
ViewContext .RequestContext); 
Var img = String.Format ( 
"<1mg src="'{0}" alt="{1}" title={l1}"' style="{2}" />", 
urlHelper.Content (1mageUr1), 
imgAltText, 
imgstyle); 
var modifiedMarkup = markup.Replace (tag, img); 
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return modifiedMarkup; 


} 
该 帮助 占 首 先 会 调用 默认 的 ActionLink 帮助 器 来 获取 URL, 正如 它 就 是 一 个 基于 文本 的 
超 链接 一 样 。 第 一 步 要 把 超 链接 文本 设置 为 一 个 已 知 字符 串 ， 用 作 占 位 符 。 接 下 来 ， 当 一 切 
准备 好 以 后 ， 该 帮助 器 会 移 除 占 位 符 字 符 串 ， 蔡 换 为 图 片 的 URL。 
为 什么 不 能 直接 提供 <img> 标 记 用 作 原 始 操作 链接 的 文本 呢 ? ActionLink 很 好 地 遵循 其 
规则 ， 它 会 对 所 有 内 容 进行 HIML 编码 ， 因 此 你 看 不 到 任何 图 片 ， 只 有 URL 的 文本 。 


2.3 Razor 视图 引 敬 


一 方面 , Web Forms 视图 引擎 采用 了 一 种 几乎 对 所 有 ASPNET 开 发 人 员 都 很 熟悉 的 语法 。 
但 是 在 男 一 方面 ，ASPX 标记 被 设计 用 作 支 持 服务 器 控件 的 一 种 方式 ， 当 主要 与 代码 块 一 起 
使 用 时 ， 会 表现 出 严重 的 局 限 性 。 很 明显 ， 其 主要 问题 是 缺乏 可 读 性 。 

在 ASPNET MVC 3 中 引入 的 Razor 视图 引擎 解决 了 这 个 问题 ， 它 提供 了 一 种 替代 标记 
语言 来 定义 视图 模板 的 结构 。 

2.3.1 视图 引擎 的 内 部 机 制 

根据 Razor， 视 图 模板 就 是 一 个 HTML 页 面 加 上 几 个 占 位 符 和 代码 片段 。 总 体 来 说 ， 视 
图 模板 的 可 读 性 大 大 提高 了 ， 并 且 通 过 将 Razor 代码 片段 与 HTML 帮助 器 相 结 合 ， 可 以 整理 
视图 ， 使 它们 更 易于 阅读 和 维护 。 

1. 搜索 位 置 

Razor 视图 引擎 支持 一 些 与 视图 模板 的 位 置 有 关 的 有 趣 属 性 。 表 2-4 描述 了 这 些 属性 。 


表 2-4 表示 用 于 视图 模板 所 需 位 置 格 式 的 属性 


AreaMasterLocationFormats 在 以 区 域 为 基础 的 应 用 程序 中 搜 过 到 的 母 版 视图 的 位 置 
AreaPartial ViewLocationFormats 在 以 区 域 为 基础 的 应 用 程序 中 搜索 到 的 部 分 视图 的 位 置 
AreaViewLocationFormats 在 以 区 域 为 基础 的 应 用 程序 中 搜索 到 的 视图 风 位 置 
MasterLocationFormats 搜索 到 的 母 版 视图 的 位 置 

Partial ViewLocationFormats 搜索 到 的 部 分 视图 的 位 置 

ViewLocationFormats 搜索 到 的 视图 的 位 置 

FileExtensions 视图 、 部 分 视图 和 和 母 版 视图 的 扩展 名 支持 列表 
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每 个 属性 都 是 由 一 个 字符 串 数组 实现 的 。 表 2-5 显示 了 这 些 属性 的 默认 值 。 


属 性 
AreaMasterLocationFormats 


AreaPartial ViewLocationF ormats 


AreaVWlewLocationFormats 


MasterLocationFormats 


Partial ViewLocationFormats 


ViewLocationFormats 


FileExtensions 


表 2-5 默认 位 置 格式 


默认 位 置 格式 


~/Areas/{2!/Views/{1}/10}.cshtml 
~/Areas/{21}/V1iews/Shared/10}.cshtml 
~/Areas/ {12+/V1iews/{1t/10!.vbhtml 
~/Areas/12+/V1liews/Shared/10}.vbhtml 
~/Areas/{2!+/V1iews/{1}/10}.cshtml 
~/Areas/12}/V1liews/ {1}/10!.vbhtml 
~/Areas/{2!/V1iews/Shared/{01}.cshtml 
~/Areas/{2!+/Views/Shared/ {01.vbhtml 
~/Areas/12}/V1iews/11}+/10}.cshtml 
~/Areas/12+/V1iews/{1}+/10+.vbhtml 
~/Areas/12!/V1iews/Shared/{01.cshtml 
~/Areas/12}/V1lews/Shared/10}.vbhtml 
~/Views/{1}/{0}.cshtml 
~/Views/Shared/ 0}.cshtml 
~/Views/{1}/{0}.vbhtml 
~/Views/Shared/ {0}.vbhtml 
~/Views/{1}/{0}.cshtml 
~/Views/{1}/{0}.vbhtml 
~/Views/Shared/ {0}.cshtml 
~/Views/Shared/10}.vbhtml 
~/Views/{1}/{0}.cshtml 
~/Views/{1}/{0}.vbhtml 
~/Views/Shared/ {0}.cshtml 
~/Views/Shared/ +0}.vbhtml 

.cshtml, .vbhtml 


医 个 多 所 有 属性 的 使 用 方式 痢 与 Web Forms 引擎 的 相同 。 对 于 视图 而 言 ， 唯 一 的 变化 是 
不 同 的 文件 扩展 名 和 不 同 的 语法 。 让 我 们 来 熟 甘 一 下 吧 。 
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2. 代码 碎 块 
Razor 视图 模板 实质 上 是 一 个 HTML 页 面 加 上 几 个 代码 段 ， 也 称 为 代码 碎 块 。 代 码 碎 块 


@ 字 符 。 蝎 为 重要 的 是 ， 你 不 需要 显 式 关闭 这 些 代 人 码 块 。Razor 分 析 器 使 用 Visual Basic 或 C# 
解析 有 逻辑 来 找 出 代码 行 的 结束 位 置 。 下 和 面 有 一 个 示例 : 


<html> 
<head> 
<title>@ViewBag.Title</title> 
<1ink href="QUr1l .Content ("~/Content/sSite.css")" rel="stylesheet" 
type="text/css™ /> 
<SCript src="@Url.Content ("~/Scripts/Jquery.Js")" 
type="text/jJavascript"></script> 
</head> 


a 
可 以 将 任何 Razor 代码 碎 块 与 普通 的 标记 相 混 合 ， 即 使 代码 碎 块 中 包含 像 if/else 或 for/ 
foreach 语句 这 样 的 控制 流 语 句 。 下 面 的 代码 利用 代码 碎 块 编写 了 一 个 页 面 : 


<body> 
<h2>@ViewBag.Header</h2> 
<hr /> 


<table> 
<thead> 
<th>City</th> 
<th>Country</th> 
<th>Been there?</th> 
</thead> 
Qforeach (var city in Model) 1{ 
<tr> 
<td><$: city.Name $></td> 
<td><%: city.Country $$></td> 
< 七 d>< 当 : city.Visited 2"Yes™ : "NO" 当 ></ 七 d> 
之 下 让 > 
} 
</table> 
</body> 


注意， 位 于 源 代码 中 间 的 右 大 括 弧 (})， 它 过 过 解析 器 得 到 正确 的 识别 和 解释 。 
一 般 来 说 ， 可 以 在 Razor 模板 中 使 用 任何 C#( 或 Visual Basic) 指 令 ， 只 要 给 它们 加 上 前 组 
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@。 下面 这 个 示例 展示 了 如 何 引用 一 个 名 称 空间 以 及 创建 一 个 表单 块 : 


Qusing YourRApp .EXxtenslons:， 


<body> 
Qusing (Htm]l .BeginForm()) ({ 
<fieldset> 
<diy class="editor-field"> 
QHtm] .TextBox ("TextBoxl™) 
</div> 
</fieldset> 
} 
</body> 


归根 结 底 ，Razor 模板 就 是 带 有 封装 了 可 执行 语句 和 “ HTML 帮助 器 的 @ 表 达 式 的 普通 
HTML 标记 文件 。 不 过 ， 存 在 几 个 快捷 方式 罢了 。 


3. 代码 碎 块 的 专用 表达 式 


可 以 通过 在 @{fcode} 块 中 进行 封装 来 在 任意 位 置 插入 整 段 的 多 行 代 码 ， 就 像 下面 所 示 的 
这 个 : 
@{ 
Var user = "Dino™ 


} 


<p>luser</p> 


可 以 检索 自己 创建 的 任意 变量 ， 并 且 之 后 可 以 像 属于 单个 代码 块 的 代码 一 样 使 用 它 。 
@{...} 块 的 内 容 可 以 混合 代码 和 标记 。 不 过 ， 重 要 的 是 解析 器 可 以 找 出 代码 于 何 处 结束 ， 标 
记 在 何 处 开始 ， 反 之 亦 然 。 请 看 看 下 面 的 代码 碎 块 : 

Qt{ 

Var number = GetRandomNumber () 
1f (number.IsEven()) 

<p>Number 1s even</p> 
else 

<text>Number 1s odd</text> 

} 

如 果 发 出 的 标记 内 容 被 HTML 标签 封装 起 来 了 , 则 解析 器 会 正确 地 将 其 作为 标记 识别 出 
来 。 如 果 是 普通 文本 (比如 一 个 文本 字符 串 )， 就 需要 将 其 用 Razor 专用 的 <text> 封 装 起 来 ， 以 
便 解 析 器 能 够 正确 地 处 理 它 。 
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来 源 于 表达 式 的 单个 语句 可 以 通过 使 用 括号 在 同一 表达 式 中 组 合 : 

<p> @ ("Welcome, " + user) </p> 

在 你 需要 放置 一 个 图 数 调用 时 ， 括 号 也 起 作用 : 

<p> @(YourMethod (1,2,3)) </p> 

由 Razor 进行 处 理 的 任何 内 容 都 是 自动 编码 的 ， 所 以 不 需要 你 处 理 。 如 果 的 代码 返回 


HTML 标记 ， 而 你 希望 原样 发 出 ， 不 进行 自动 编码 ， 那 么 你 应 该 采用 如 下 所 示 的 HtmLRaw 
帮助 器 方法 : 


QHtml .Raw(Strlngds .HtmlMessade) 


最 后 ， 在 多 行 代码 碎 块 @{...} 的 内 部 ， 你 要 使 用 C# 或 Visual Basic 语言 的 语法 来 放置 注 
释 。 可 以 通过 使 用 @*...* @ 语 法 来 注释 整个 Razor 代码 块 ， 如 下 所 示 : 


@t+x 
<div> Some Razor markup </div> 

大 人 

用 于 添加 或 移 除 注释 块 的 Visual Studio 工具 栏 按钮 可 以 很 好 地 支持 Razor 语法 。 
注意 : 


大 部 分 时 候 ，Razor 解析 器 足以 智能 地 从 上 下 文中 获悉 你 使 用 @ 符 号 的 原因 ， 无 论 是 表 
示 代码 碎 块 还 是 电子 邮件 文本 地 址 。 如 果 遇 到 解析 器 不 能 成 功 解析 的 极端 情况 ， 请 使 用 @@ 
明确 表示 出 你 希望 @ 符 号 按 文本 解析 ， 而 不 是 代码 碎 块 的 起 始 符 . 

4. 条 件 式 代码 碎 块 


Razor 还 支持 一 些 条 件 特性 ， 只 有 在 Razor 表达 式 为 真 或 不 为 空 的 时 候 才 应 发 出 。 让 我 
们 思考 下 面 的 标记 : 


<div class="@yourCss"> 


</d1iv> 


变量 yourCss 可 能 为 空 或 null; 在 这 种 情况 下 理论 上 你 不 会 想 要 发 出 这 一 类 特性 。 在 
ASPNET MVC 4 以前， 你 不 得 不 上 自己 写 一 些 条 件 逻 辑 。 而 现在 ， 条 件 人 逻辑 已 经 内 置 在 Razor 
引擎 中 了 。 

请 注意 如 果 Razor 表达 式 是 布尔 值 ， 情 况 是 一 样 的 : 如 果 它 返回 false 或 者 为 null， 该 特 


第 2 章 ASPNET MVC 视图 


性 不 应 友 出 。 
5.Razor 视图 对 象 


Razor 视图 引擎 在 使 用 时 ， 生 成 的 视图 对 象 是 一 个 在 System.Web.Mvec 程序 集中 定义 的 
WebViewPage 类 的 实例 。 这 个 类 集成 了 解析 标记 和 呈现 HIML 的 逻辑 。 该 类 上 的 公共 属性 对 
于 你 在 实际 模板 中 编写 的 任何 代码 碎片 都 可 用 。 

表 2-6 提供 了 你 可 能 感 兴趣 的 几 个 属性 的 简单 列表 。 


表 2-6 ”Razor 视图 对 象 的 弟 用 属性 和 万 法 


属 性 摘 ” 述 

Ajax 获取 一 个 用 于 在 模板 中 引用 Ajax HTML 帮助 器 的 AjaxHelper 类 的 实例 

Culture 获取 和 设置 与 当前 请 求 相 关 的 区 域 性 ID。 该 设置 会 影响 页 面 区 域 性 依赖 特性 ， 比 如 日 
期 、 数 字 和 货币 格式 。 区 域 性 表现 为 xx-yy 格 式 ， 其 中 xx 表示 语言 、 邓 表示 区 域 

Href 将 你 在 服务 磺 问 代码 (其 中 可 以 包 舍 ~ 运算 符 ) 中 创建 的 路 径 转 换 成 浏览 二 理 解 的 路 径 

Html 获取 一 个 用 于 在 模板 中 引用 HIML 帮助 器 的 HtmlHelper 类 的 实例 

Context 获取 中 心 资 源 库 以 获得 各 种 ASPNET 内 部 对 象 的 访问 权 : 请 求 、 啊 应 、 服 务 器 、 用 户 

IsAjax 如 果 当 前 请 求 由 浏览 器 的 Ajax 对 象 初始 化 ， 则 返回 true 

IsPost 如 果 当 前 请 求 通过 HTTP POST 动词 发 出 ， 则 返回 true 

Layout 获取 和 设置 包含 母 版 视图 模板 的 文件 路 径 

Model 获取 一 个 包含 视图 数据 的 视图 模型 对 象 ( 如 果 有 的 话 ) 的 引用 。 这 一 属性 是 动态 类 型 

UICulture 获取 和 设置 与 当前 请 求 相 关 的 用 户 界 面 区 域 性 中。 这 一 设置 会 判定 在 多 语言 应 用 程序 
中 加 载 哪个 资源 。 区 域 性 表现 为 xx-yy 格式 ， 其 中 xx 表示 语 吝 、Yy 表示 区 域 

ViewBag 获取 一 个 ViewBag 字典 的 引用 ， 访 字典 可 能 包含 控制 器 需要 传递 给 视图 对 象 的 数据 

ViewData 获取 一 个 ViewData 字典 的 引用 ， 该 字典 可 能 包含 控制 器 需要 传递 给 视图 对 象 的 数据 


并 不 是 所 有 这 些 属性 都 能 直接 在 WebViewPage 类 上 得 到 有 效 的 定义 。 其 中 很 多 实际 上 是 
在 父 类 上 定义 的 。 


2.3.2 ”设计 一 个 样 例 视 图 


要 创建 一 个 具有 一 定 复 洒 上 度 的 Razor 视图 ， 需 要 了 解 如 何 将 数据 传递 给 视图 ， 以 及 如 何 
定义 母 版 视图 。 
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1. 定义 用 于 视图 的 模型 


如 前 所 述 ， 控 制 器 能 以 各 种 方式 将 数据 传递 给 视图 。 它 可 以 使 用 全 局 字典 ， 如 ViewBag 
或 ViewData。 更 好 的 是 ， 控 制 器 可 以 使 用 为 特定 视图 量 身 定做 的 强 类 型 对 象 。 稍 后 我 会 详 述 
各 种 方法 的 利 束 。 

要 从 代码 碎 块 中 使 用 ViewBag 或 ViewData， 不 需要 采取 任何 特别 措施 。 只 需要 编写 读 入 
或 写 进 字典 的 @ 表 达 式 即 可 。 相 反 ， 要 使 用 强 类 型 的 视图 模型 ， 你 需要 在 模板 文件 的 顶部 声 
明 实 际 的 类 型 ， 如 下 所 示 : 


Qlmodel IList<GridDemo.Models.City> 


用 于 表示 类 型 的 语法 与 你 在 整个 模板 中 编写 代码 碎 块 所 使 用 的 语言 相同 。 接 着 ， 通 过 使 
用 Model 属性 访问 视图 模型 对 象 中 的 属性 ， 如 表 2-6 中 所 列 示 的 。 下 面 是 一 个 示例 : 


model IL1ist<GridDemo.Models .City> 
@1{ 

ViewBag.Title = ViewBag.Header; 
} 


<h2>@ViewBag .Header</h2> 
<hr /> 


<table> 
<thead> ... </thead> 
Qforeach (var city in Model) 


{ 

“Er es Er 
} 
</tabley> 


当然 ， 如 果 Model 引用 了 有 具有 子 属 性 的 对 象 ， 那 么 可 以 使 用 Model.Xxx 来 引用 每 个 子 
属性 ， 

注意 : 

在 基于 Visual Basic 的 Razor 视 图 中 ,定义 视图 模型 对 象 是 通过 使 用 不 同 的 语法 来 实现 的 。 
不 是 使 用 @model 关键 字 ， 而 要 用 (@ModelType 关键 字 ， 

2. 定义 母 版 视图 

在 Razor 中 , 布局 页 面 扮演 着 Web Forms 中 母 版 页 的 角色 ,布局 页 面 是 一 个 标准 的 Razor 
模板 ， 视 图 引擎 会 将 你 定义 的 任意 视图 呈现 出 来 ， 从 而 将 外 观 和 感觉 与 网 站 版 面 统一 起 来 。 

每 个 视图 都 可 以 通过 简单 地 设置 布局 属性 来 定义 其 布局 页 面 。 布 局 可 以 设置 成 硬 编码 文 
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件 或 设置 成 从 计算 运行 时 条 件 中 所 产生 的 任意 路 径 : 


国 | 
if (Request.Browser.IsMobileDevice) ({ 
Layout = "mobile.cshtm]l"; 
} 
} 


你 不 必 在 每 个 视图 文件 中 都 集成 确定 布局 的 代码 。 使 用 Razor， 可 以 在 Views 文件 夹 中 
定义 一 个 特殊 文件 ， 该 文件 在 每 个 视图 构建 和 呈现 之 前 进行 处 理 。 这 个 文件 被 称 为 
_ViewStart.cshtml,， 是 任何 与 视图 相关 的 局 动 代 码 的 理想 容器 ,其 中 包括 决定 使 用 哪个 布局 的 
代码 。 下 面 是 ViewStart.cshtml 文件 的 一 个 常见 实现 : 


Qf 
Layout = "~/Views/Shared/ Layout.cshtm]l"; 
} 


根据 前 面 的 代码 片段 ，_Layout.cshtml 文件 定义 了 网 站 中 每 个 视图 的 总 体 结构 (这 只 是 与 
母 版 页 对 应 的 Razor)。 

布局 页 面包 含 了 HTML 代码 和 代码 雁 块 的 第 见 组 合 ， 征 从 WebViewPage 派生 而 来 的 。 
因此 ， 它 可 以 访问 WebViewPage 的 任何 属性 ， 包 括 ViewBag 和 ViewData。 布 局 模板 必须 包 
含 至 少 一 个 占 位 符 用 于 注入 特定 视图 的 代码 。 占 位 符 通 过 调用 RenderBody 方法 (在 
WebViewPage 上 定义 ) 来 表达 ， 如 下 面 这 个 示例 所 揭示 的 : 


<html> 
<head> 
<title>@ViewBag.Title</title> 
<11Ink href="@Url.cCcontent ("~/Content/sSite.css")" rel="stylesheet™" 
type—"text/css" /> 
<SCript src="@Url.Content ("~/Scripts/Jquery-—1.9.1 .min.J]s")" 
type="text/Javascript"></script> 
</head> 
<body> 
<div class="page"> 
QRenderBody () 
</d1liv> 
</body> 
</html> 


执行 RenderBody 方法 会 导致 实际 视图 中 的 任何 代码 都 注入 布局 模板 。 实 际 视图 模板 中 
的 代码 会 在 视图 和 布局 合并 之 前 进行 处 理 。 这 意味 着 可 以 在 布局 能 够 检索 和 使 用 的 ViewBag 
中 编写 以 编程 方式 设置 值 的 视图 代码 。 一 个 典型 例子 就 是 网 页 标题 。 男 一 个 适用 示例 是 
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<Ireta> 标签 四 


重 归 提示 : 

在 视图 中 ， 建 议 你 通过 使 用 波浪 号 (~) 运 算 符 将 诸如 图 片 、 脚 本 和 样式 衣 等 资源 引用 到 网 
站 的 根 目 录 。 在 ASPNET MVC 的 早期 版 本 中 ， 你 不 得 不 借助 Url.Content 方法 ， 以 确保 波 泥 
号 (~) 在 URL 中 的 正确 扩展 。 从 ASPNETMVC 4 开始， 波浪 号 (~) 通 过 Razor 引擎 自动 扩展 ， 
虽然 UrlLContent 的 使 用 依然 受到 支持 ， 但 已 不 再 必要 。 


3. 定义 节 


RenderBody 方法 定义 了 在 布局 内 注入 的 单个 点 。 虽然 这 是 一 种 常见 情 形 , 但 你 可 能 需要 
将 内 容 注 入 到 多 个 位 置 。 在 布局 模板 中 ， 你 通过 在 希望 节 所 出 现 的 位 置 放 置 一 个 对 
RenderSection 的 调用 来 定义 注入 点 : 


<body> 
<div class="page"> 
GRenderBody () 
</d1iv> 
<div id="footer"™"> 

GRendersection ("footer"™) 

</d1iv> 

</body> 


每 一 个 节 都 由 名 称 标识 ， 并 能 标记 为 可 选 。 要 声明 基 个 节 是 可 选 的 ， 可 以 参考 下 面 的 
代 体 : 
<div 1d="footer™> 
QRendersection ("footer", false) 
</d1liv> 
RenderSection 方法 接受 可 选 的 布尔 值 参 数 ， 它 表明 是 耕 需 要 某 一 节 。 下 面 的 代码 在 功能 
上 等 同 于 之 前 的 代码 ， 但 从 可 读 性 的 角度 来 说 要 好 得 多 : 
<div 1d="footer™> 
QRendersection ("footer", requlired:false) 
</d1liv> 
注意 ， 那 个 required 并 不 是 关键 字 ; 简 言 之 ， 它 是 在 RenderSection 方法 上 定义 的 形式 参 
数 的 名 称 (其 名 称 的 友好 显示 得 益 于 智能 提示 )。 
如 果 视 图 模板 不 包含 所 需 的 节 ， 你 会 得 到 一 个 运行 时 异常 。 下 面 展示 了 如 何在 视图 模板 
中 定义 节 的 内 容 : 


@section footer 1{ 
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<p>Written by Dino Esposito</p> 
} 
可 以 在 Razor 视图 模板 的 任何 位 置 定义 节 的 内 容 。 
如 果 需 要 将 整个 视图 直接 发 送 到 输出 流 ， 那 么 还 可 以 使 用 RenderPage 方法 。RenderPage 
方法 使 用 视图 的 URL 进行 呈现 。 其 总 体 作 用 与 你 在 ASPX 视图 中 可 能 大 量 使 用 过 的 
RenderPartial 扩展 方法 闫 不 多 。 


4. 市 的 默认 内 容 


Web Forms 视图 引擎 中 的 母 版 页 可 以 让 你 指定 一 些 用 于 占 位 符 的 默认 内 容 ， 以 防 实际 的 
页 面 未 填写 这 些 内 容 。 这 一 特征 本 身 不 受 Razor 支持 ， 但 可 以 制定 一 些 快速 的 解决 方法 。 尤 
其 是 ，WebViewPage 类 提供 了 一 个 方便 的 IsSectionDefined 方法 , 可 以 用 在 Razor 模板 中 确定 
给 定 的 节 是 否 已 被 指定 。 这 里 有 一 些 可 以 在 布局 页 面 中 使 用 的 代码 ， 用 以 指明 可 选 节 的 默认 
内 容 : 


Q* This code belongs to a Layout page *@ 
<div 1id="footer™"> 
@1if (IsSectionDefined ("Copyright")) 
{ 
@RenderSection ("copyright") 
} 
else 
{ 
<hr /><span>Rights reserved for a better use.</span> 
} 
</div> 


请 记 住 太 的 名 称 不 区 分 大 小 写 。 

5. 座 套 布局 

可 以 对 Razor 布局 进行 任意 程度 的 能 人 套 。 假 设 你 需要 将 由 标准 ASPNET MVC 应 用 程序 
所 创建 的 About 视图 进行 更 为 复杂 的 转换 .About 视 图 基于 一 般 的 网 站 布局 _Layout.cshtml 


文件 。 进 一 步 假 设 你 希望 它 接 受 来 自 外 部 视图 模板 的 联系 人 信息 。 下 面 是 你 所 期 望 的 结构 : 


@1 


ViewBag.Title = "About Us"™; 
} 
<h2>About</h2> 
<p> 
dRenderBody () 
</p> 
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你 不 能 直接 请 求 布局 模板 一 即 任何 名 为 RenderBody 的 Razor 模板 ;一 旦 尝试 直接 请 求 ， 
就 会 得 到 一 个 异常 。 这 意味 着 你 必须 重 命名 about.cshtml 文件 ， 将 其 修改 成 类 似 于 
aboutLayout.cshtml 的 名 称 ， 如 前 面 的 代码 中 所 示 。 另 外 ， 你 必须 显 式 地 提 及 它 所 基于 的 父 
布局 : 

@ 1{ 


Layout = "~/Views/Shared/ Layout.cshtml"; 
ViewBag.Title = "About Us"; 


} 
<h2>About</h2> 
<p> 
GRenderBody () 
</p> 
最 后 ， 可 以 创建 实际 的 about.cshtml 视图 了 ， 它 是 由 应 用 程序 直接 请 求 的 : 
@1 
Layout = "~/Views/Home/AboutLayout.cshtml™"; 
} 
<fieldset> 


<legend>Contact</legend> 
<p>Follow me on Twitter: Ql@despos</p> 
</fieldset> 


6. 声明 式 HTML 帮助 器 


如 你 在 这 一 革 前 面 了 所 看 到 的 ，HTML 关 助 并 是 构建 可 重用 、 参 数 化 的 HTML 所 段 的 有 
力 工具 。 它 是 作为 HtmlHelper( 或 AjaxHelper) 类 的 扩展 方法 来 编写 的 ， 可 以 轻松 地 在 Razor 
模板 中 引用 帮助 器 而 不 需要 更 改 哪怕 是 一 个 代码 。 此 规则 适用 于 , 比方 说 , 所 有 内 置 的 HTML 
帮助 需 ， 包 括 那 些 用 于 发 出 表单 或 操作 链接 的 帮助 器 。 

将 HTML 帮助 器 编写 为 扩展 方法 的 缺点 是 ,它们 在 表达 图 形 布局 方面 的 灵活 性 有 限 。 例 
如 ， 要 生成 一 个 HIML 表格 ， 需 要 将 标记 组 合 到 一 个 字符 串 生 成 器 中 。 可 以 这 样 做 , 但 并 不 
真正 有 效 。 在 Razor 中 ， 你 有 了 一 个 替代 方案 : 声明 式 帮 助 器 。 

首先 你 要 在 该 项 目的 App Code 文件 夹 中 创建 一 个 .cshtml 文件 。 项 目 向 导 不 会 自动 创建 
该 文件 夹 ， 所 以 你 需要 自己 动手 (奇怪 的 是 ， 该 文件 夹 甚至 不 会 作为 ASPNET 文件 夹 列 示 )。 
你 为 .cshtml 文件 所 选 的 名 称 很 重要 ， 因 为 在 调用 帮助 器 时 会 用 到 。 可 以 将 此 文件 夹 看 作 是 你 
的 一 个 帮助 器 资源 库 。 它 的 一 个 经 典 的 名 称 类 似 于 MyHelpers.cshtml。 下 面 是 其 中 的 一 些 内 容 : 


Qusing RazorEngine.Models; 


Qhelper CityGrid(IList<City> cities) 
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<table> 
<thead> ... </thead> 
Qforeach (var city in cities) 
{ 
LPS 
<td>@city.Name</td> 
<td>@city.Country</td> 
<td>@ (city.Visited ? “Yes™ : "No")</td> 
</tr> 


} 
</table> 


} 


Qhelper ShowHeader () 
| 

<h2>I'm a Razor declarative helperI!I</h2> 
} 


@helper 关键 字 就 是 HTML 声明 的 开头 部 分 。 紧 跟 关 键 字 后 面 的 是 方法 的 签名 和 实现 。 
帮助 器 主体 只 是 Razor 模板 的 一 个 艇 入 式 片 段 。 可 以 在 单个 文件 中 有 多 个 帮助 器 (请 记 住 ， 如 
果 帮 助 器 资源 库 位 于 App_Code 文件 夹 之 外 ， 那 它 不 会 被 检测 出 来 )。 

要 调用 声明 式 Razor 帮助 器 ， 请 按照 下 面 所 显示 的 来 做 : 


Qusing RazorEngine.Models; 
QQmodel IList<City> 
QMyHelpers .ShowHeader () 
<p> 

QMyHelpers .CityGrid (Model) 
</p> 


帮助 右 的 名 称 由 两 部 分 组 成 : 资源 库 名 称 和 帮助 嚣 名称。 


2.4 讽 图 编码 


在 本 章 的 最 后 一 节 ， 将 深入 探究 影响 视图 和 控制 器 的 两 个 重要 方面 : 如 何 有 效 地 将 数据 
传递 给 视图 以 及 如 何 增加 视图 呈现 处 理 的 灵活 性 。 
2.4.1 视图 建 模 

使 用 Razor( 或 ASPX 引擎 ), 需要 定义 视图 的 图 形 布 局 。 有 时 候 , 视图 只 由 静态 内 容 构 成 。 
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但 更 多 时 候 ， 视 图 必须 集成 系统 中 间 层 操作 所 产生 的 实际 数据 ， 或 者 从 应 用 程序 缓存 或 会 话 
状态 中 加 载 的 数据 。 如 何 把 这 些 数据 提供 给 视图 呢 ? 

ASPNET MVC 设计 的 黄金 法 则 声明 ， 视 图 会 接收 但 不 会 计算 它 要 显示 的 任何 数据 。 可 
以 通过 三 种 非 独 占 性 的 方式 传递 数据 : ViewData 字典 、ViewBag 字 骨 以 及 量 身 定做 的 容器 对 
象 ， 也 第 被 称 作 视图 模型 对 象 。 


1. ViewData 字典 


ViewData 属性 直接 由 Controller 类 公开 ， 
Session 或 其 他 ASPNET 内 部 对 象 : 


public ActionResult Index() 
{ 


它 是 名 称 - 值 字典 对 象 。 其 编程 模型 类 似 于 使 用 


ViewDatal[l"PageTitle"] = "Programming ASP.NET MVC"; 
return View({(); 


} 


你 存储 在 字典 中 的 任何 数据 都 会 被 当 作 一 个 对 象 来 处 理 ， 需 要 转换 、 装 箱 、 或 这 两 者 一 
起 以 便 被 视图 所 用 。 可 以 按 需 在 字典 中 创建 条 目 。 人 字典 的 生存 周期 与 请 求 的 生存 周期 是 一 
样 的 。 

ViewData 字典 被 封装 到 视图 上 下 文中 一 一 一 种 内 部 结构 ， 通 过 它 ASPNET MVC 基础 染 
构 将 数据 从 控制 器 级 别提 高 到 视图 级 别 一 并 提供 给 视图 引擎 .视图 对 象 一 -ASPX 引擎 中 的 
ViewPage 和 Razor 中 的 WebViewPage 一 一 问 视 图 模板 中 的 代码 公开 ViewData 字典 。 以 下 显 
示 了 如 何 从 视图 模板 检索 ViewData 内 容 : 

<head> 

<title> @ViewDatal["PageTitle"] </title> 

</head> 

请 记 住 你 不 会 被 限于 仅 在 ViewData 字典 中 存储 字符 串 。 

总 体 而 言 ，ViewData 字典 易于 使 用 且 非 党 灵活 。 实 际 上 ， 它 允许 你 通过 直接 创建 一 个 新 
条 目 来 把 新 的 数据 传递 给 视图 。 同时， 基于 名 称 的 模型 强制 你 使 用 大 量 的 “魔幻 字符 串 ”( 纯 
文本 字符 串 ， 比 如 前 面 示例 中 的 PageTitle)， 且 更 重要 的 是 ， 要 将 这 些 字 符 串 在 控制 器 和 视图 
代码 之 间 匹 配 。 通 过 使 用 癌 量 ， 可 以 减少 魔幻 字符 串 的 一 些 内 在 脆弱 性 ， 但 你 仍然 无 法 避免 
抓 取 错误 名 字 的 可 能 。 如 果 碰 巧 引 用 了 错误 的 字典 条 目 ， 则 只 有 在 运行 时 才能 发 现 了 。 
ViewData 字典 非常 适合 于 简单 的 解决 方案 和 相对 较 短 生命 周期 的 应 用 程序 。 随 着 字典 条 目 数 
量 和 视图 数量 的 增长 ， 维 护 会 成 为 一 个 问题 ， 因 此 寻找 其 他 选项 时 应 该 摆脱 ViewData。 
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2. ViewBag 字典 


ViewBag 属性 也 在 Controller 类 上 进行 定义 ， 它 提供 了 一 个 更 加 灵活 的 将 数据 传递 给 视 
图 的 工具 。 记 属 性 被 定义 为 动态 类 型 ， 如 下 所 未 : 


public dynamic ViewBag { get; } 


当 .NET 编译 需 遇 到 一 个 动态 类 型 时 ， 它 会 发 出 特殊 的 代码 块 而 不 是 简单 地 计算 表达 式 。 
这 种 特殊 的 代码 块 会 将 表达 式 传递 到 动态 语言 运行 时 (Dynamic Language Runtime，DLR) 用 于 
运行 时 计算 。 换 句 话说 , 基于 动态 类 型 的 任何 表达 式 都 会 被 编译 成 在 运行 时 解释 。 从 ViewBag 
中 设置 或 读 取 的 任何 成 员 总 是 被 编译 器 所 接受 ， 但 其 实 是 在 执行 时 才 会 被 计算 。 下 面 是 一 个 
比较 ViewData 和 ViewBag 用 法 的 示例 : 


public ActionResult Index() 


{ 
// Using ViewData 
ViewDatal["PageTitle"™"] = "Programming ASP.NET MVC",; 


// Using ViewBag 
ViewBag.PageTitle = "Programming ASP.NET MVC"; 


return View(): 

} 

编译 器 并 不 关心 名 为 PageTitle 的 属性 是 否 真 的 存在 于 ViewBag 上 。 它 所 做 的 只 是 将 调 
用 打包 给 DLR 解释 器 , 在 那里 编译 器 要 求 DLR 尝试 为 某 特定 PageTitle 属性 分 配 一 个 指定 字 
符 串 。 同 样 地 ， 当 从 ViewBag 中 读 取 PageTitle 时 ， 编 译 器 会 指示 DLR 检查 是 否 存 在 这 样 的 
属性 。 如 果 不 存在 ， 则 编译 器 会 抛 出 一 个 异常 。 以 下 代码 显示 了 如 何在 Razor 视图 中 使 用 
ViewBasg 的 内 容 : 

<head> 

<title> @ViewBag.PageTitle </title> 

</head> 

从 开发 人 员 的 角度 来 看 ， 哪 一 个 更 好 ，ViewBag 还 是 ViewData? 

ViewBag 的 语法 比 ViewData 的 语法 更 为 简洁 ， 但 就 我 看 来 ， 这 就 是 所 有 的 区 别 了 。 和 
ViewData 中 的 情形 一 样 ， 不 会 在 编译 时 检查 属性 。 如 果 键 入 了 错误 的 属性 名 称 ， 那 么 由 于 动 
态 类 型 对 DLR 的 依赖 , 将 不 可 避免 地 产生 运行 时 异常 。 归 根 结 底 , 这 纯粹 是 由 个 人 偏好 所 决 
定 的 。 还 有 一 个 重要 问题 ，ViewBasg 至少 需要 是 ASPNETMVC 3 和 .NET4， 而 ViewData 的 
适用 范围 是 ASPNET MVC 的 任何 版 本 和 .NET 2.0。 
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注意 : 

动态 类 型 是 在 运行 时 解析 的 , 因此 Visual Studio 智能 提示 不 能 指示 任何 有 关 属 性 的 内 容 。 
智能 提示 会 把 动态 类 型 看 作 是 首 通 的 Object 类 型 。 有 些 工具 一 一 最 引 人 注 目的 是 JetBrains 
ReSharper 一 一 要 更 智能 一 些 。ReSharper 会 一 路 跟踪 动态 变量 使 用 范围 内 所 遇 到 的 所 有 属 
性 。 对 于 任何 使 用 过 的 属性 ， 都 会 在 智能 提示 菜单 中 添加 一 个 条 目 。 

3. 强 类 型 视图 模型 

当 你 有 几 十 个 不 同 的 值 传 递 到 视图 时 ， 快 速 添 加 新 条 目 或 重 命名 现 有 条 目的 灵活 性 束 成 
为 了 最 大 的 敌人 。 你 只 能 自己 跟踪 项 的 名 称 和 值 ; 智能 提示 和 编译 器 都 帮 不 了 你 。 

处 理 软件 中 复杂 性 的 唯一 经 证 明 有 效 的 方法 是 合适 的 设计 。 因 此 ， 为 每 个 视图 定义 一 个 
对 象 模型 可 以 帮助 你 跟踪 视图 的 真实 所 需 。 建 议 你 为 每 一 个 添加 到 应 用 程序 中 的 视图 定义 一 
个 视图 模型 类 : 


public ActionResult Index() 


{ 
// Pack data for the view using a view-specific container object. 
Var model = new YourViewModel () : 
// Populate the model. 
// Trigger the view. 
return View (model); 
} 


每 个 视图 都 有 一 个 视图 模型 类 ， 这 也 会 造成 选择 合适 的 类 名 称 的 问题 。 可 以 使 用 控制 器 
名 称 和 视图 名 称 的 一 个 组 合 。 例 如 ， 从 Home 控制 器 调用 的 命名 Index 的 视图 ， 其 视图 模型 
对 象 可 能 被 命名 为 HomeIndexViewMeodel。 更 好 的 做 法 是 , 可 以 在 Models 文件 夹 中 创建 一 个 
名 为 Home 的 子 文件 夹 ， 并 在 其 中 托管 一 个 mdexViewModel 类 。 在 我 的 应 用 程序 中 ,我 也 常 
将 Models 重 命名 为 ViewModels( 这 种 特殊 方法 只 是 一 个 建议 ;你 应 该 自由 地 选择 有 意义 的 
名 称 )。 

那么 如 何 开发 一 个 视图 模型 类 呢 ? 

首先 ， 视 图 模型 对 象 是 一 个 只 有 数据 而 (几乎 ) 没 有 行为 的 普通 数据 传输 对 象 。 理 想 情况 
下 ， 视 图 模型 对 象 上 的 属性 会 完全 以 视图 所 期 望 的 格式 公开 数据 。 例 如 ， 如 果 预 计 视 图 只 显 


@@ JetBrainsReSharper 是 一 款 微软 Visual Studio 的 插件 , 提供 了 智能 C# 辅 助 编码 功能 和 实时 错误 显示 功 
能 ， 并 支持 重 构 。 
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示 待 办 订单 的 日 期 和 状态 ， 就 不 会 想 要 传递 一 个 完整 Order 对 象 的 普通 集合 ， 因 为 它们 是 从 
中 间 层 产生 的 。 下 面 的 视图 模型 类 是 视图 用 于 数据 建 模 的 更 好 选择 。 它 有 助 于 保持 表示 层 和 
中 间 层 的 解 灯 。 

public class LatestOrderViewModel 

{ 

public DateTime OrderDate { get; set; } 
public String Status { get; set; } 

} 

ASPNET MVC 基础 架构 保证 了 ViewData 和 ViewBag 始终 可 用 于 视图 对 象 而 无 需 开发 人 
员 的 任何 干预 。 而 自 定 义 视图 模型 对 象 就 不 是 这 样 了 。 

当 你 使 用 一 个 视图 模型 对 象 时 ， 必 须 在 视图 模板 中 声明 该 视图 模型 类 型 ， 这 样 实际 的 视 
图 对 象 就 可 以 创建 成 ASPX 视图 引擎 中 的 ViewPage<T> 关 型 ; 如 果 使 用 的 是 Razor 的 话 ， 则 
会 创建 成 Razor 引擎 中 的 WebViewPage <T> 类 型 。 如 果 使 用 ASPX Web Forms 视图 引擎 ， 下 
面 就 是 需要 在 .aspx 模板 中 准备 的 内 容 : 

<SQ@ Page Language="C#" MasterPageFile="~/Views/Shared/site.Master" 

Inherits="System.Web.Mvc .ViewPage<LatestOrderViewModel>™ $> 

在 前 面 的 代码 片段 中 ， 分 配给 Inherits 特性 的 类 型 不 是 完全 合格 的 。 这 意味 着 你 可 能 需 
要 添加 一 个 @Import 指令 来 指定 查找 视图 模型 类 型 需 导 入 的 名 称 空间 。 如 果 视 图 引擎 是 
Razor， 你 所 需要 的 是 : 

amode1l LatestoOrderVviewModel 

要 在 视图 模板 中 检索 视图 模型 对 象 ,可 以 使 用 在 WebViewPage 和 ViewPage 上 都 定义 过 
的 Model 属性 。 下 面 是 一 个 Razor 的 例子 : 


<h2> 
Latest order placed 
<span class="highlight">@Model.OrderDate.ToString ("dddd, dd MMM yyyy") 


</span> 
<br /> 
Status 1s: <span class="highlight">@Model .status</span> 
</h2> 


在 该 示例 中 ， 日 期 的 格式 是 在 视图 中 建立 的 。 控 制 器 使 日 期 成 为 字符 串 ， 并 将 它 传 递 给 
视图 以 备 显示 ， 这 也 是 可 以 接受 的 。 代 码 的 归属 问题 并 没有 一 个 明确 的 标准 ， 它 掉 进 了 一 个 
灰色 区 域 。 我 偏好 尽量 保持 视图 的 简单 。 如 果 格式 是 固定 的 ， 不 依赖 运行 时 条 件 ， 那 么 传递 
DateTime 而 由 视图 解决 其 余 的 问题 对 你 来 说 就 是 可 行 的 。 当 设置 日 期 格式 需要 有 点 逻辑 的 时 
候 ， 我 通常 会 将 它 移 到 控制 器 。 
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虽然 每 个 视图 都 应 该 有 上 自己 的 模型 对 象 ， 但 限制 你 要 处 理 的 类 的 数量 通常 是 一 个 好 选 
择 。 要 在 多 个 视图 中 重用 模型 类 ， 你 往往 需要 生成 一 个 类 的 层次 体系 。 下 面 是 视图 模型 基 类 
public class VlIewModel1Base 
{ 
public String Title { get; set; } 
public String Header { get; set; } 
} 


public class LatestOrderViewModel : ViewModelPBase 
{ 


} 
最 后 ， 围 纸 视 图 而 非 数 据 来 设计 视图 模型 类 的 结构 往往 是 一 个 好 办 法 。 换 句 话 说 ， 我 种 
常 倾 则 于 把 视图 模型 类 设计 为 一 个 容器 。 


假设 你 需要 传递 一 个 订单 列表 到 视图 。 首 先 在 头脑 中 出 现 的 选项 应 该 是 使 用 下 面 的 视图 
模型 类 (在 Razor 模板 中 ): 


QQmodel IList<PendingOrder> 


从 功能 上 讲 ， 这 个 方法 是 可 行 的 。 但 可 扩展 性 呢 ? 以 我 的 经 验 来 看 ， 你 最 后 总 是 需要 在 
视图 中 填充 各 种 开 构 数据 。 由 于 重 构 工 作 以 及 突然 出 现 的 新 需求 ， 这 可 能 是 必要 的 。 下 面 是 
一 个 更 易于 维护 的 方法 (允许 你 在 不 更 改 控 制 右 /视图 界面 的 情况 下 重 构 ): 


QQmodel YourViewModel 


在 本 例 中 ，YourViewModel 的 定义 如 下 所 示 : 
public class YourViewModel 
{ 
public IList<PendingOrder> PendingOrders {get; set;} 


} 
视图 模型 类 最 终 是 为 视图 建 模 而 不 是 为 数据 。 


重要 提示 : 

我 不 确定 表达 得 是 否 足 够 清楚 ， 所 以 换个 方式 衣 述 一 下 吧 。 对 于 至 少 中 等 复杂 程度 和 中 
等 持续 时 间 的 任何 ASPNET MVC 应 用 程序 来 说 ， 强 类 型 视图 模型 是 唯一 安全 而 可 行 的 解决 
方法 。 我 相信 使 用 可 模型 更 多 是 一 种 心态 而 不 是 对 抗 复杂 性 的 方 加 但 是 ， 如 果 想 方 设 法 
忽略 了 视图 模型 ， 么 为 每 个 视图 配备 几 个 ViewData 或 ViewBag 条 目 也 能 完成 任务 ， 但 是 
几 个 月 wy 该 站 点 (比如 设置 用 于 某 一 特定 事件 的 站 点 ) . 
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4. 封装 视图 模型 类 


应 该 在 何 处 定义 视图 模型 关 呢 ? 这 主要 取 雇 于 项 目的 大 小 。 在 具有 更 好 可 重用 性 和 预期 
更 长 使 用 寿命 的 大 型 项 目 中 ， 你 可 能 要 以 所 使 用 的 所 有 视图 模型 类 来 创建 一 个 单独 的 类 库 。 

在 小 项 目 中 ， 你 可 能 需要 把 所 有 的 类 隔离 到 一 个 特定 的 文件 夹 中 。 这 可 以 是 Models 文 
件 夹 ， 这 是 为 你 所 创建 的 默认 Visual Studio 项 目 模 板 。 就 个 人 而 言 ， 我 倾 癌 于 将 Models 重 命 
名 为 ViewModels， 并 将 其 分 组 在 控制 占 专 属 的 子 文 件 夹 中 ， 如 图 2-6 所 示 。 


人 | -日 加 外 | 后 


seEarch solutron Explorer (Ctrlre) 


E# IndexViewhvlodel,cs 
b 上 别 Shared 
Cs ViewNlodelBase,cs 
别 Views 
古 ] Global,asax 
人 Web.config 


图 2-6 ViewModels 文件 严 的 建议 结构 
2.4.2 ”高 级 功能 


ASPNET MVC 的 构建 是 基于 约定 优 于 配置 的 模式 的 。 如 同 典 型 框架 一 样 ， 这 个 模式 为 
开发 人 员 节 省 了 很 多 的 编程 细节 ， 只 要 他 们 遵守 一 些 固定 的 规则 和 约定 。 这 在 视图 中 表现 得 
尤其 明显 。 

视图 引擎 的 工作 方式 是 检索 和 处 理 视 图 模板 。 它 如 何 获知 模板 的 情况 呢 ? 一 般 来 说 ， 它 
会 以 下 面 两 种 方式 生效 : 用 引擎 注册 已 知 的 视图 (配置 )， 或 将 视图 放置 在 特定 的 位 置 ， 以 便 
引擎 可 以 检索 它们 (约定 )。 如 果 要 依据 一 组 不 同 的 约定 组 织 自己 的 视图 呢 ? 很 简单 ， 这 需要 
你 自己 的 视图 引擎 。 

注意 : 

对 自 定 义 视图 引 芝 的 需求 可 能 比 最 初 想象 的 更 为 频繁 。 创 建 自 定 义 视 图 引 芝 的 主要 原因 
大 致 有 两 个 : 希望 以 一 种 新 的 标记 语言 表示 视图 ， 或 者 你 希望 应 用 一 套 个 性 化 约定 。 并 不 是 
说 每 个 应 用 程 厅 都 该 使 用 自 定 义 的 标记 语言 ， 但 大 多 数 应 用 程序 都 可 能 从 以 自 定义 方式 组 织 
的 视图 中 受益 。 
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1. 自 定 义 视 图 引擎 

我 的 大 部 分 应 用 程序 都 采用 它们 自己 的 视图 引擎 ， 它 们 以 略微 不 同 的 方式 组 织 视图 ， 或 
者 需要 一 层 额外 的 代码 将 视图 名 称 解 析 成 实际 的 标记 文件 。 如 果 出 于 某 些 原因 需要 对 一 些 视 
图 使 用 不 同 的 目录 结构 ， 那 么 只 需要 派生 一 个 简单 的 类 ， 如 下 所 示 : 


Public class MyViewEngine : RazorViewEngine 


{ 
public MyViewEngine () 
{ 
this.MasterLocationFormats = base.MasterLocationFormats; 
this.ViewLocationFormats = new stringl[] 
{ 
~/Views/{1}/{0}.cshtml"™ 
}; 
// Customize the location for partial views 
this.PartialViewLocationFormats = new stringl[] 
{ 
"~/fPartialViews/{1}/{0}.cshtml ™, 
n~/fPartialViews/{1}/{0} .vohhtml" 
}; 
} 
} 


要 用 这 个 类 代 葵 默认 的 视图 引擎 ， 需 要 在 global.asax 中 输入 下 面 的 内 容 : 


protected vold Application Start () 


{ 
// Removes the default engines and adds the new one. 
ViewEngines .Englines.Clear (); 
ViewEngines.Engines.Add (new MyViewEngine ()); 

} 


这 样 一 来 ， 如 果 任 何 一 个 部 分 视图 不 在 Partial Views 子 文件 夹 中 ， 你 的 应 用 程序 都 会 出 
问题 。 

注意 : 

虽然 就 自 定义 视图 引 苇 而 言 ， 设 置 自 定义 位 置 是 有 道理 的 ， 但 你 应 该 牢记 如 果 要 做 的 仅 
仅 是 设置 其 中 一 个 默认 引 敬 的 位 置 格式 属性 ， 那 真 的 不 必 创 建 一 个 自 定义 视图 引擎。 你 可 以 
直接 在 Application Start 中 检索 当前 实例 ， 以 及 设置 位 置 格式 属性 。 
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重要 提示: 

如 果 有 一 个 支持 自 定 义 文件 夹 (比如 对 部 分 视图 进行 分 组 的 PartialViews 文件 夹 ) 的 自 定 
义 视图 引 学 ， 则 向 其 添加 一 个 web.config 文件 是 十 分 必要 的 。 可 以 复制 在 Views 文件 夹 中 所 
找到 默认 的 与 web.config 相同 的 文件 。 该 文件 包含 了 使 ASPNET MVC 运行 时 正确 定位 视图 
类 的 重要 信息 . 


2. 呈现 操作 


复 森 视图 由 子 视图 的 各 种 组 合 产 生 而 来 。 当 控制 器 方法 触发 一 个 视图 的 呈现 时 ， 它 必须 
壹 全 视图 的 主 结构 和 各 相关 部 件 所 需 的 所 有 数据 。 有 时 候 ， 这 了 融 要 求 控制 右 了 解 很 多 天 于 应 
用 程序 部 件 的 详细 情况 ， 而 这 些 信息 可 以 使 得 类 本 身 不 用 直接 参与 。 我 们 来 举例 说 明 。 
假设 你 有 一 个 在 很 多 视图 中 呈现 的 染 单 。 不 论 你 进行 任何 与 应 用 程序 相关 的 操作 ， 沫 单 
都 必须 呈现 。 因 此 ， 呈 现 染 单 是 一 个 与 当前 正在 处 理 的 请 求 不 直接 相关 的 操作 。 你 要 如 何 应 
付 此 种 情况 呢 ? 呈现 操作 是 一 个 可 行 的 答案 。 
呈现 操作 是 专门 设计 用 来 从 视图 内 部 进行 调用 的 控制 器 方法 。 因 此 呈现 操作 是 控制 器 类 
上 的 一 个 常规 方法 ， 可 以 通过 使 用 下 面 的 一 个 HTML 帮助 右 Action 或 RenderAction 
来 从 视图 中 进行 调用 。 
QHtml .Action ("action") 
Action 和 RenderAction 的 作用 差不多 相同 ;唯一 的 区 别 是 Action 将 标记 作为 字符 串 返 回 ， 
而 RenderAction 直接 写 入 输出 流 。 这 两 种 方法 都 文 持 多 种 重 载 ， 通 过 这 些 重 载 ， 可 以 指定 多 
个 参数 ， 包 括 路 由 值 、HTML 特性 ， 当 然 还 有 控制 器 名 称 。 可 以 将 呈现 操作 定义 为 控制 器 类 
上 的 第 规 方法 ， 也 可 以 将 其 定义 为 某 些 视图 相关 操作 的 呈现 程序 : 
public ActionResult Menu () 
Var options = new MenuOptionsViewModel (); 
options.Items.Add (new MenuOption {Url="...", Image="..."™}); 
options.Items.Add (new MenuOption {Url="...", Image="..."™}); 


return PartialView (options); 


} 
此 处 沫 单 的 部 分 视图 的 内 容 是 不 相关 的 ; 它 的 作用 只 是 获得 模型 对 象 和 呈现 适当 的 标记 
片段 。 我 们 看 看 应 用 程序 中 可 能 有 的 茶 个 页 面 的 视图 源 代码 : 


<dlv> 
QHtml .RenderAct1ion ("Menu") 


</d1iv> 
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RenderAction 帮助 右 方 法 会 调用 指定 控制 器 上 (或 命令 呈现 当前 视图 的 控制 器 ) 的 Menmu 方 
法 ， 并 引导 对 输出 流 的 任何 啊 应 。 用 这 种 方式 ， 视 图 会 集成 一 些 逻 辑 并 回调 该 控制 器 。 同 时 ， 
你 的 控制 器 不 需要 担心 视图 信息 的 传递 ， 它 与 当前 处 理 的 请 求 并 不 是 严格 相关 的 。 


3. 子 操 作 


呈现 操作 的 执行 并 不 是 通过 反射 对 一 个 方法 进行 调用 那么 简单 。 该 过 程 中 发 生 了 很 多 事 
情 。 尤 其 是 ， 呈 现 操 作 是 在 主要 用 户 请 求 界 限 之 内 发 起 的 子 请 求 。RenderAction 方法 会 生成 
一 个 新 的 请 求 上 下 文 ， 它 包含 与 父 请 求 相同 的 HTTP 请求 上 下 文 和 一 组 不 同 的 路 由 值 。 这 一 
子 请 求 会 被 转发 到 一 个 特定 的 HTTP 处 理 程序 一 一 ChildActionMvcHandler 类 一 一 并 当 作 该 子 
请 求 来 自 浏览 器 的 情况 进行 处 理 。 整 体 的 运作 类 似 于 你 调用 服务 器 时 的 情况 。 会 在 普通 的 
ASPNET 编程 中 执行 。 虽 然 没 有 重 定 向 和 往返 ， 但 子 请 求 会 通过 常规 ASPNET MVC 请 求 的 
通用 管道 ， 并 接受 操作 筛选 器 的 应 用 ， 这 可 能 遭遇 一 些 异 常情 况 。 其 中 ， 算 选 器 不 会 跨 子 操作 
工作 的 最 稼 见 的 例子 是 AuthorizeRequest 和 OutputCache( 本 书后 面部 分 还 会 谈 到 操作 算 选 器 )。 

默认 情况 下 ， 任 何 操作 方法 都 可 以 从 URL 调用 和 通过 呈现 操作 调用 。 但 是 任何 以 
ChildActionOnly 特性 标记 的 操作 方法 都 不 会 提供 给 公共 调用 方 , 对 它们 的 使 用 仅 限 于 呈现 操 
作 和 子 请 求 。 


2.5 本章 小 结 


ASPNET MVC 不 会 将 URL 与 磁盘 文件 相 匹配 ; 相反 ， 它 会 解析 URL， 找 出 要 采取 的 下 
一 个 请 求 操作 。 每 个 操作 都 终止 于 一 个 操作 结果 。 最 常见 的 操作 结果 类 型 是 视图 结果 ， 它 是 
由 大 量 HTML 标记 构成 的 。 

视图 结果 由 控制 器 方法 生成 ， 由 模板 和 模型 构成 。 视 图 引擎 负责 解析 视图 模板 和 填补 模 
型 数据 。 ASPNET MVC 带 有 两 个 默认 的 视图 引擎 ， 它 们 各 自 支持 不 同 的 表示 模板 和 在 不 同 
磁盘 位 置 发 现 模板 的 标记 语言 。 如 今 ，Razor 是 最 常用 的 视图 引擎 ， 它 取代 了 旧式 的 包含 很 
多 经 典 ASPNET 内 容 的 ASPX 语法 ， 但 它 却 不 允许 (这 是 合理 的 ) 使 用 服务 器 控件 。 

在 这 一 章 中 ， 我 们 首先 审视 了 处 理 视 图 的 必要 和 条件， 然后 着 重 于 开发 方面 ， 包 括 使 用 
HTML 帮助 器 以 及 用 于 两 个 默认 引擎 ASPX 和 Razor 的 模板 化 帮助 器 。 我 们 还 讨论 了 对 数据 
建 模 的 最 佳 做 法 ， 并 以 强 类 型 的 视图 模型 对 字典 做 了 对 比 。 

建议 你 看 看 同步 学 习 源 代码 中 的 BasicApp 示例 ， 以 便 更 好 地 理解 本 章 所 讨论 的 内 容 。 在 
ASPNET MVC 5 中， 由 Visual Studio 回 导 生成 的 默认 应 用 程序 是 基于 Twitter( 推 特 ) 引 导 程 序 
的 ， 并 且 提 供 了 一 个 能 适应 不 同 屏幕 尺寸 的 图 形 化 模板 。 


中 


异型 绑 定 来 构 


不 怕 慢 ， 就 怕 停 ， 
一 志 子 


默认 情况 下 ， 用 于 ASPNET MVC 应 用 程序 的 微软 Visual Studio 标准 项 目 模板 包含 一 个 
Models 文件 来。 如果 查看 一 下 它 的 使 用 指导 以 及 其 预期 作用 的 有 关 信 息 , 很 快 会 得 出 Models 
文件 夹 是 用 于 存储 模型 类 的 结论 。 那 么 ， 叉 是 哪些 模型 呢 ? 或者， 更 确切 地 说 ,“ 模 型 ”的 定 
义 是 什么 ? 

我 想 说 , “模型 ”是 软件 发 展 历史 上 被 人 误解 最 深 的 概念 。 它 需要 被 扩展 才能 成 为 现代 
软件 中 的 合理 概念 。 在 引入 模型 -视图 -控制 右 (MVC) 模 式 的 时 候 ， 软 件 工 程 正 处 于 起 步 阶段 ， 
应 用 程序 也 比 今天 要 简单 得 多 。 没 有 人 真正 觉得 有 必要 把 模型 的 概念 分 解 得 更 详细 。 然 而 这 
种 更 详 细 的 情况 却 己 经 存在 了 。 

我 发 现 通常 存在 至 少 两 种 完全 不 同 的 模型 领域 模型 和 视图 模型 。 前 者 描述 你 在 中 间 层 
使 用 的 数据 ， 预 期 会 为 填充 业务 领域 的 实体 和 关系 提供 可 靠 的 表示 。 这 些 实体 一 般 通 过 数据 
访问 层 来 持久 保存 ， 并 且 通 过 实现 业务 流程 的 服务 来 使 用 。 领 域 模型 推动 了 数据 的 可 视 化 ， 
通常 会 使 其 更 为 鲜明 ， 但 同时 可 能 与 你 在 表示 层 发 现 的 可 见 数据 不 同 。 视 图 模型 只 摘 述 了 表 
示 层 中 正在 处 理 的 数据 。 一 个 典型 例子 就 是 标准 的 Order 实体 。 可 能 有 一 些 用 例 是 应 用 程序 
需要 问 用 户 呈 现 订 单 集合 ， 但 并 不 是 所 有 属性 都 要 显示 。 比 如 ， 你 可 能 需要 显示 ID、 日 期 、 
总 额 ， 以 及 一 个 独特 的 容器 类 一 一 数据 传输 对 象 (DTO)。 

话 虽 如 此 ， 但 我 同意 并 不 是 每 个 应 用 程序 都 必须 将 表示 层 与 业务 层 中 使 用 的 对 象 模型 严 
格 分 开 。 你 可 能 出 于 自己 的 目的 ， 决 定 让 这 两 种 模型 基本 重合 ， 但 应 该 始终 意识 到 在 两 个 不 
同 层 中 运行 着 两 种 不 同 模型 的 事实 。 

这 一 章 会 介绍 模型 的 第 三 种 类 型 : 输入 模型 ， 虽 然 它 隐藏 在 ASPNET Web Forms 运行 时 
之 中 多 年 ， 但 在 ASPNET MVC 中 它 被 独立 划分 出 来 了 。 提 交 的 数据 会 通过 输入 模型 公开 给 
控制 器 , 随后 被 应 用 程序 接收 。 输 入 模型 定义 了 应 用 程序 用 来 从 输入 表单 处 接收 数据 的 DTO。 
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注意 : 
还 有 一 种 类 型 的 模型 没有 在 这 里 提 及 , 就 是 数据 模型 或 者 说 用 于 持久 保存 数据 的 (主要 是 
关系 ) 模 型 ， 


3.1 输入 模型 


第 1 草 “ASPNET MVC 控制 器 ”讨论 了 请 求 路 由 以 及 控制 器 方法 的 整体 结构 。 第 2 章 
“ASPNET MVC 视图 ”探讨 了 作为 操作 处 理 初步 结果 的 视图 。 但 是 这 两 章 都 未 能 深入 讨论 
在 ASPNET MVC 中 控制 器 方法 是 如 何 获取 输入 数据 的 。 

在 ASPNET Web Forms 中 ， 我 们 有 服务 器 控件 、 视 图 状态 、 还 有 在 后 人 台 运 行 的 整个 页 面 
生命 周期 来 服务 于 准备 好 使 用 的 输入 数据 。 使 用 ASPNET Web Forms， 开 发 人 员 无 须 担 心 输 
入 模型 。ASPNET Web Forms 中 的 服务 器 控件 为 客户 端 用 户 界面 提供 了 一 个 可 靠 的 服务 器 端 
表示 。 开 发 人 员 只 需要 编写 C# 代 人 码 从 输入 控件 中 读 取 即 可 。 

ASPNET MVC 强调 用 控制 器 接收 而 个 是 检索 输入 数据 。 要 将 输入 数据 传递 给 控制 器 ， 
需要 以 某 种 方式 把 数据 封装 起 来 。 而 这 正 是 输入 模型 发 挥 作 用 的 时 候 。 

为 了 更 好 地 了 解 新 的 ASPNET MVC 输入 模型 的 重要 性 和 能 力 ， 我 们 首先 从 ASPNET 
Web Forms 的 输入 数据 开始 介绍 。 


3.1.1 Web Forms 输入 处 理 的 演变 


ASPNET Web Forms 应 用 程序 是 基于 页 面 的 ， 而 每 个 服务 器 页 面 则 基于 服务 器 控件 。 页 
面具 有 上 自己 的 生命 周期 ， 从 处 理 原始 的 请 求 数据 时 起 ， 到 组 织 用 于 浏览 器 的 最 终 啊 应 时 止 。 
页 面 的 生命 周期 一 路 伴随 着 原始 的 请 求 数据 ， 如 HTTP 标 头 、cookies、URL 和 正文 ， 并 产生 
一 个 包含 标 头 、cookies、 内 容 类 型 和 正文 的 原始 HTTP 啊 应 。 

在 页 面 生命 周期 内 部 的 几 个 步骤 中 ，HTTP 原始 数据 会 被 传递 进 更 易于 编程 的 容器 一 一 
服务 器 控件 中 。 在 ASPNET Web Forms 中 ， 这 些 “ 可 编程 容器 ”永远 不 会 作为 输入 对 象 模型 
的 一 部 分 来 被 识别 ,在 ASPNET Web Forms 中 , 输入 模型 仅 是 基于 服务 器 控件 和 视图 状态 的 。 


1. 服务 器 控件 的 作用 


假设 你 有 一 个 网 页 ， 它 有 儿 个 TextBox 控件 来 捕获 用 户 名 称 和 密码 。 当 用 户 提交 该 表单 
的 内 容 时 ， 可 能 有 一 段 类 似 于 如 下 所 示 的 代码 来 处 理 该 请 求 : 


public void Buttonl Click(Object sender, EventArgs e) 

{ 
// You're about to perform requested action using input data. 
CheckUserCcredentials (TextBox] .Text, TextBox2.Text); 
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} 


ASPNET Web Forms 架构 的 总 体 思 路 是 使 开发 人 员 远 离 原始 数据 。 任 何 传 入 的 请 求 数据 
都 被 映射 成 服务 器 控件 的 属性 。 当 无 法 使 用 这 种 方式 时 ， 数 据 会 被 留 在 通用 容器 里 ， 如 
QueryString 或 Form。 
你 对 刚才 所 示 的 像 Buttonl_Click 这 样 的 方法 有 什么 期 待 ? 该 方法 是 控制 器 操作 的 Web 
Forms 对 应 方法 。 下 面 的 内 容 介 绍 如 何 重 构 前 面 的 代码 以 便 能 使 用 显 式 输入 模型 : 
public void Buttonl Click(Object sender, EventArgs e) 
{ 
// You're actually filling In the input model of the page. 
Var model = new UserCredentialsInputModel () ; 
model .UserName = TextBoxl]l .Text; 
model .Password = TextBox2 .Text; 


// You're about to perform the regquested action using input data. 
CheckUserCredentials (model); 


} 


ASPNET 运行 时 环境 会 将 原始 的 HTTP 请 求 数据 分 解 成 控件 属性 ， 从 而 提供 了 以 控件 为 
中 心 的 请 求 处 理 方法 。 


2. 视图 状态 的 作用 


从 编程 模式 来 说 ，ASPNET Web Forms 和 ASPNET MVC 的 一 个 主要 区 别 是 视图 状态 。 
在 Web Forms 中 , 视图 状态 帮助 服务 器 控件 随时 更 新 。 正 是 因为 有 了 视图 状态 ,作为 开发 者 ， 
你 不 用 去 关注 在 回 传 过 程 中 不 会 接触 到 的 用 户 界 面部 分 。 假 定 你 要 显示 一 个 可 以 下 拉 展 开 的 
选项 列表 。 当 提交 详细 信息 的 请 求 时 ， 只 需要 在 Web Forms 中 显示 出 这 些 详细 信息 即 可 。 而 
原始 的 HTTP 请 求 会 提交 这 个 选项 列表 以 及 所 寻找 的 关键 信息 。 视 图 状态 使 你 不 用 杀 上 自 去 处 
理 这 个 选项 列表 。 

视图 状态 和 服务 器 控件 在 和 全 典 的 HTTP 机 制 之 上 构建 了 厚实 的 抽象 层 ， 它们 让 你 从 页 面 
序列 方面 而 不 是 连续 的 请 求 方面 来 考虑 问题 。 这 没什么 对 错 可 言 ; 它 只 是 Web Forms 背后 的 
模式 而 已 。 在 Web Forms 中 ， 确 实 没 有 清楚 定义 输入 模型 的 必要 。 如 果 这 样 做 了 ， 也 只 是 因 
为 你 希望 代码 更 为 简洁 和 更 具 可 读 性 。 


3.1.2 ASPNET MVC 中 的 输入 处 理 
第 1 章 前 述 了 控制 堪 方 法 可 以 通过 Request 集合 一 一 如 QueryString、Headers 或 Form 一 一 
或 值 提供 程序 来 访问 输入 数据 。 这 虽然 很 实用 ， 但 从 可 读 性 和 维护 的 角度 看 这 种 方法 并 不 理 
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想 。 你 需要 一 个 对 控制 器 公开 数据 的 专用 模型 。 
1. 模型 绑 定 器 的 作用 


ASPNET MVC 提供 了 一 个 自动 绑 定 层 ， 它 使 用 一 组 内 置 的 规则 将 原始 的 请 求 数据 从 任 
何 一 个 值 提供 程序 映射 到 输入 模型 类 的 属性 。 作 为 开发 者 ， 你 要 在 很 大 程度 上 负责 输入 模型 
类 的 设计 。 就 输入 数据 的 处 理 而 言 ， 绑 定 层 的 逻辑 可 以 在 很 大 程度 上 进行 自 定义 扩展 ， 从 而 
使 灵活 性 达到 前 所 未 有 的 高 度 。 


2. 模型 的 种 类 


ASPNET MVC 的 默认 项 目 模 板 只 提供 了 一 个 Models 文件 夹 , 因此 可 大 致 推论 出 “模型 
的 概念 指 的 就 是 : 应 用 程序 应 该 使 用 的 数据 模型 。 大 致 上 讲 ， 这 样 的 看 法 过 于 简单 ， 但 对 于 
简单 的 网 站 来 说 是 有 效 的 。 

如 果 看 得 更 深入 一 些 ， 就 会 认识 到 在 ASPNET MVC 中 有 三 种 不 同类 型 的 “模型 ” 如 图 
3-1 所 示 。 


输入 模型 域 模型 


图 3-1 ASPNET MVC 应 用 程序 中 可 能 涉及 的 模型 类 型 


输入 模型 提供 了 正在 提交 到 控制 器 的 数据 的 表示 。 视 图 模型 所 供 了 正在 视图 中 进行 处 理 
的 数据 的 表示 。 最 后 ， 域 模型 是 在 中 间 层 中 操作 的 域 特定 实体 的 表示 。 

请 注意 这 三 种 模型 并 不 是 完全 分 开 的， 图 3-1 在 某 种 程度 上 显示 出 来 了 。 你 会 发 现 模型 
之 间 有 章 合 。 这 意味 看 域 模型 中 的 类 可 能 会 用 在 视图 中 ， 从 客户 端 提 交 的 类 也 可 能 用 在 视图 
中 。 类 的 最 终结 构 和 关系 图 取决 于 你 目 己 。 


3.2 ”模型 绑 定 

模型 绑 定 是 指 将 通过 HTTP 请 求 所 提交 的 值 绑 定 到 控制 器 方法 所 用 的 参数 的 过 程 。 我 们 
来 看 看 更 多 有 关 底 层 基 础 结构 、 机 制 和 所 涉及 组 件 的 内 容 。 
3.2.1 模型 绑 定 的 基础 结构 

模型 绑 定 逻辑 是 封装 在 一 个 特殊 的 模型 绑 定 器 类 中 的 。 绑 定 器 在 操作 调用 程序 的 控制 下 
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工作 ， 并 玫 助 找 出 归 传 递 给 所 选择 的 控制 右 方 法 的 参数 。 
1. 分 析 方 法 的 签名 


第 1 章 指 出 每 一 个 传递 到 ASPNET MVC 的 请 求 都 会 按照 控制 器 名 称 和 操作 名 称 来 解析 。 
配备 好 这 两 块 数据 ， 操 作 调 用 程序 一 一 一 个 ASPNET MVC 运行 时 shell 的 原生 组 件 一 一 就 可 
以 发 挥 实际 服务 请 求 的 作用 了 。 首 先 ， 调 用 程序 会 把 控制 器 名 称 扩展 成 一 个 类 名 称 ， 并 将 操 
作 名 称 解 析 为 控制 器 类 上 的 方法 名 称 。 如 果 发 生 错 误 ， 就 会 抛 出 异常 。 

然后 ， 调 用 程序 会 收集 进行 方法 调用 所 需 的 所 有 值 。 与 此 同时 ， 它 会 查看 方法 的 签名 ， 
试图 找 出 签名 中 每 个 参数 所 需 的 输入 值 。 


2. 为 类 型 获取 绑 定 器 


操作 调用 程序 知道 每 个 参数 的 正式 名 称 , 并 声明 各 个 参数 的 类 型 (此 信息 是 通过 反射 获得 
的 )。 操 作 调 用 程序 还 能 够 访问 请 求 上 下 文 以 及 与 HTTP 请 求 一 起 上 载 的 任何 数据 一 一 查询 字 
符 串 、 表 单数 据 、 路 由 参数 、cookies、 标 头 、 文 件 等 。 

对 于 每 一 个 参数 ， 调 用 程序 都 会 获得 一 个 模型 绑 定 器 对 象 。 模 型 绑 定 器 是 一 个 知道 如 何 
从 请 求 上 下 文 查找 指定 类 型 的 值 的 组 件 。 模 型 绑 定 器 会 应 用 它 自己 的 算法 ， 包 括 参 数 名 称 、 
参数 类 型 和 可 用 的 请 求 上 下 文 ， 并 返回 一 个 指定 类 型 的 值 。 算 法 的 细节 归属 于 该 类 型 用 到 的 
模型 绑 定 器 的 实现 。 

ASPNET MVC 使 用 对 应 于 DefaultModelBinder 类 的 内 置 绑 定 器 对 象 。 模 型 绑 定 器 是 一 
个 实现 了 IModelBinder 接口 的 类 。 


Public interface IModelBinder 
{ 
Object BindModel (ControllerContext controllerContext, 
ModelBindingContext bindingContext); 
} 


我 们 首先 探讨 默认 绑 定 器 的 功能 ， 然 后 看 看 为 特定 类 型 编写 自 定 义 绑 定 器 需要 些 什 么 
条 件 。 
3.2.2 ”默认 模型 绑 定居 

默认 模型 绑 定 器 使 用 基于 规则 的 逻辑 ， 将 提交 的 值 的 名 称 与 控制 器 方法 中 的 参数 名 称 相 
匹配 。DefaultModelBinder 类 知道 如 何 处 理 简 单 和 复杂 类 型 ， 也 清楚 如 何 处 理 集 合 和 字典 。 
由 此 ， 默 认 绑 定 器 大 部 分 时 间 都 能 正常 运行 。 

注意 : 


如 果 默 认 绑 定 器 支持 简单 类 型 和 复杂 类 型 以 及 两 者 的 集合 ， 你 觉得 还 有 使 用 其 他 绑 定 器 
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的 必要 吗 ? 你 几乎 不 会 认为 有 用 另 一 种 通用 型 绑 定 器 来 取代 默认 绑 定 器 的 需要 。 但 是 ， 默 认 
绑 定 器 不 能 应 用 你 的 自 定义 逻辑 将 请 求 数据 传递 到 指定 类 型 的 属性 中 去 。 在 后 面 的 内 容 中 你 
会 看 到 ， 当 请 求 所 提交 的 值 不 能 与 你 期 望 控制 器 所 使 用 类 型 的 属性 完全 相 匹 配 时 ， 自 定义 绑 
定 器 就 非常 有 用 了 。 在 这 种 情况 下 ， 自 定义 的 绑 定 器 不 仅 有 用 ， 还 能 帮助 保持 控制 器 代码 的 
至 精 至 简 。 

1. 绑 定 简单 类 型 

不 可 人 否认， 似乎 有 些 不 可 思议 ， 但 模型 绑 定 背 后 的 确 没 有 什么 神奇 之 处 。 模 型 绑 定 的 关 
键 一 点 在 于 ， 它 使 你 可 以 将 注意 力 完 全 放 在 你 希望 控制 嚣 方法 所 接收 的 数据 上 。 可 以 完全 忽 
略 如 何 检索 数据 的 细节 ， 不 论 数 据 是 来 和 目 于 得 询 字 符 串 还 是 路 由 。 

假定 你 需要 控制 器 方法 按照 给 定 的 次 数 重复 某 个 特定 的 字符 串 。 下 面 就 是 你 需要 做 的 : 


Public class BindingController : Controller 


{ 
public ActionResult Repeat (String text, Int32 number) 
{ 
Var model = new RepeatVviewModel {Number = number, Text = text}; 
return View (model).; 
} 
} 


像 这 样 设计 ， 控制 器 就 具有 了 高 度 可 检验 性 ， 并 能 从 ASPNET 运行 时 环境 完全 解 耦 。 
此 你 不 用 直接 访问 Request 对 象 或 Cookies 集合 。 

文本 和 数字 的 值 是 从 哪儿 来 的 呢 ? 具 体 又 是 哪个 组 件 将 它们 读 入 文本 和 数字 参数 
的 呢 ? 

从 请 求 上 下 文 读 取 的 实际 值 和 默认 模型 绑 定 器 对 象 是 起 作用 的 关键 。 尤 其 是 ， 默 认 绑 定 
右 会 试图 将 形 参 的 名 称 (本 例 中 是 文本 和 数字 ) 与 随 请 求 提 交 的 名 称 值 相 匹 配 。 也 就 是 说 ， 如 
果 请 求 携 带 有 表单 字段 、 人 查询 字符 串 字 段 或 者 名 称 为 文本 的 路 由 参数 ， 那 么 携带 的 值 就 会 自 
动 绑 定 到 文本 参数 。 只 要 参数 类 型 和 实际 值 是 兼容 的 ， 映 射 就 会 成 功 。 如 果 不 能 执行 转换 ， 
则 会 抛 出 参数 异 利 。 下 面 的 URL 可 以 正 利 使 用 : 


http://server/binding/repeat?text=Dino&number=2 
相反 ， 下 面 的 URL 会 引发 异常 : 
http://server/binding/repeat?text=Dino&tnumber=true 


上 述 碍 询 字 符 串 字段 文本 包含 Dino, 其 到 Repeat 方法 上 的 String 文本 参数 的 映射 是 成 功 
的 。 另 一 方面 ， 查 询 字符 串 字 段 的 数字 包含 tue， 因 此 不 可 能 成 功 映 射 到 一 个 Int32 参数 。 模 
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型 绑 定 器 返回 一 个 其 中 的 number 条 日 包含 null 的 参数 字典 。 因 为 该 参数 的 类 型 是 Int32 一 一 
也 就 是 非 空 的 类 型 一 一 因此 调用 程序 会 抛 出 参数 异常 。 


2. 处 理 可 选 值 


由 于 传递 无 效 值 而 抛 出 的 参数 异 第 不 会 在 控制 占 级 别 检测 出 来 。 异 第 在 执行 流程 到 达 控 
制 占 之 前 就 触发 了 。 这 意味 着 你 不 可 能 用 try/catch 块 来 捕获 它 。 

如 果 默 认 模 型 绑 定 器 无 法 找到 与 所 十 方法 参数 相 匹 配 的 提交 值 ， 那 么 它 会 在 参数 字典 中 
放置 一 个 null 值 ， 该 参数 字典 会 返回 给 操作 调用 程序 。 同 样 的， 如 果 null 值 不 能 为 参数 类 型 
所 接受 ， 那 么 在 控制 占 方 法 被 调用 之 前 就 会 被 抛 出 一 个 参数 措 第 。 

如 采 必 须 把 方法 参数 作为 可 选项 呢 ? 

一 个 可 行 的 办 法 是 将 参数 的 类 型 更 改 为 允许 空 值 的 类 型 ， 如 下 所 示 : 

Public ActionResult Repeat (String text, Nullable<Int32> number) 

var model = new RepeatViewModel {Number = number.GetValueOrDefault(), 

Text = textl}; 
return View (model); 

} 


男 一 种 方法 包含 了 参数 的 默认 值 使 用 : 


public ActionResult Repeat (String text, Int32 number=4) 


{ 
Var model = new RepeatViewModel {Number = number, Text = text}; 


return View (model); 

} 

控制 器 方法 的 签名 由 你 自己 决定 。 一 般 情 况 下 ， 你 可 能 希望 使 用 接近 于 随 请 求 上 传 的 真 
实数 据 的 类 型 。 例 如 ， 使 用 Object 参数 类 型 就 不 会 引发 参数 异常， 但 这 将 导致 难以 编写 简洁 
的 代码 来 处 理 输入 的 数据 。 

默认 绑 定 器 可 以 映射 所 有 简单 类 型 ， 如 String、 整 数 类 型 、Double、Decimal、Boolean、 
DateTime 以 及 相关 的 集合 。 要 在 URL 中 表示 Boolean 类 型 , 需要 借助 于 true 或 false 字符 串 。 
这 些 字 符 串 使 用 .NET 原生 Boolean 解析 函数 解析 ， 能 够 不 区 分 大 小 写 地 识别 true 和 false 字 
符 串 。 如 果 使 用 yes/no 这 样 的 字符 串 表 示 Boolean， 默 认 绑 定 器 是 不 能 识别 你 的 意图 的 ， 它 
会 在 参数 字典 中 发 出 一 个 null 值 ， 从 而 导致 参数 异常 。 


3. 值 提 供 程 序 和 优先 级 


默认 模型 绑 定 右 会 使 用 所 有 已 注册 的 值 提供 程序 将 提交 值 与 方法 参数 进行 匹配 。 默 认 情 
帝 下 ， 值 提供 程序 涵 南 了 表 3-1 中 所 列 出 的 集合 。 
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表 3-1 默认 值 提供 程序 所 涵盖 的 请 求 集合 


集 合 摘 ” 述 
Form 如 来 有 的 话 ， 则 会 包含 从 HTML 表单 提交 的 值 
RouteData 包含 摘 日 URL 跨 由 的 值 
QueryString 包含 指定 为 URL 痛击 字符 串 的 全 
Files 如 采 有 的 话 ， 则 信 为 上 传 文件 的 所 有 内 容 


表 3-1 列 出 了 笛 要 在 默认 绑 定 器 中 按照 确切 顺序 进行 处 理 的 请 求 集 合 。 假 设 你 有 下 面 的 
路 由 : 


routes .MapRoute 


“es 
"{controller}/{action}/test/ {number}", 
new { controller = "Binding", action = "RepeatWithPrecedence", 


number = 2 } 
) 7 
可 以 看 到 ， 该 路 由 具有 一 个 名 为 number 的 参数 。 现 在 思考 下 面 这 个 URL: 
/Binding/RepeatWithPrecedence/test/10?text=Dino&tnumber=2 
该 请 求 会 上 传 两 个 值 , 它们 是 在 RepeatWithPrecedence 方法 中 设置 number 参数 的 值 的 理 
想 对 象 。 第 一 个 值 是 10， 是 名 为 number 的 路 由 参数 的 值 。 第 二 个 值 是 2， 是 名 为 number 的 
QueryString 元 素 的 值 。 该 方法 目 身 提供 了 一 个 数字 参数 的 默认 值 : 


public ActionResult RepeatWithPrecedence (String text, Int32 number=20) 
{ 


} 


实际 上 选中 了 哪个 值 呢 ? 表 3-1 表明 ， 实 际 上 传递 给 该 方法 的 值 是 10， 它 是 从 路 由 数据 
集合 中 读 取 的 值 。 

4. 绑 定 复杂 类 型 

可 以 在 方法 签名 上 列 出 的 参数 的 数目 没有 上 限 。 但 是 ， 一 个 容器 类 往往 比 一 个 各 种 参数 
的 长 列表 要 好 。 对 于 默认 模型 关 定 融 ， 无 论 你 列 出 一 系列 参数 ， 还 是 复杂 类 型 的 一 个 参数 ， 
结果 几乎 相同 。 这 两 种 方案 部 完全 受到 文 持 。 下 面 是 一 个 示例 : 

Public class ComplexController : Controller 

{ 

public ActionResult Repeat (RepeatText inputModel) 


第 3 章 ， 模型 绑 定 架构 


{ 
Var model = new RepeatViewModel 
{ 
Title = "Repeating text", 
Text = inputModel .Text, 
Number = inputModel .Number 
}; 
return View (model).; 
} 


该 控制 器 方法 会 接收 一 个 RepeatText 类 型 的 对 象 。 该 类 是 一 个 普通 的 数据 传输 对 象 ， 其 
定义 如 下 : 


public class RepeatText 
{ 


public String Text { get set; } 
public Int32 Number { get; set; } 
} 
可 以 看 到 ， 这 个 类 只 包含 与 前 面 示例 中 作为 单个 参数 传递 的 值 相同 的 值 。 模 型 绑 定 器 能 
够 处 理 该 复杂 类 型 ， 就 像 它 处 理 单 个 值 的 情况 一 样 。 
对 于 声明 的 类 型 (本 例 中 是 RepeatTexb 中 的 每 一 个 公共 属性 , 模型 绑 定 需 都 会 寻找 其 关键 
字 名 称 与 属性 名 称 相 匹 配 的 提交 值 。 匹 配 不 区 分 大 小 写 。 下 面 是 一 个 使 用 RepeatText 参数 类 
型 的 示例 URL 


http://server/Complex/Repeat?text=ASP .NETS$20MVC&number=5 


图 3-2 sks 该 URL 可 能 会 生成 的 输出 。 


| 之 'S = ES at /localhost:3195/complewrepeatitext=ASP.NET 20MV Canumbers=5 


\ = Repeating text 


Repeating text a given number of times... 


= ASP.NET MYC 
= AsP.NET MYC 
- ASP.NET MYC 
= ASPNET MYC 
= ASP.NET MYC 


图 3-2 从 一 个 复杂 类 型 中 提取 的 市 值 的 午 复 文本 
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5. 绑 定 集合 


如 果 控 制 器 方法 预期 的 参数 是 一 个 集合 呢 ? 比如 ， 可 以 把 提交 表单 的 内 容 绑 定 到 一 个 
IList <T> 参 数 吗 ? DefaultModelBinder 类 可 以 帮助 你 做 到 , 但 这 样 做 需要 你 目 己 想 点 办 法 。 看 
看 图 3-3。 


Emails submitted 


图 3-3 该 页 面 会 提交 一 个 字符 串 数组 


当 用 户 单 击 Send 按钮 时 ， 该 表单 会 所 交 内 容 。 具 体 来 说 ， 它 会 发 送 不 同文 本 框 的 内 容 。 
如 有 果 这 些 文本 框 具有 不 同 的 万 ， 那 么 提交 的 内 容 会 采用 以 下 形式 : 


TextBoxl=admin@contoso.com&TextBox2~=&TextBox3=&TextBox4=&TextBox5= 


在 经 典 的 ASPNET 中 ， 这 是 唯一 行 得 通 的 办 法 ， 因 为 你 不 能 把 同一 个 D 分 配给 多 个 控 


件 。 但 是 ， 如 果 自 己 管理 HTML 的 话 ， 是 可 以 将 该 图 中 五 个 文本 框 分 配 到 同一 ID 的 。 事 实 


上 ，HTML DOM 完全 支持 这 种 情况 (虽然 不 被 推荐 )。 因 此 ， 下 面 的 标记 在 ASPNET MVC 中 
是 完全 合法 的 ， 并 且 会 生成 对 所 有 浏览 器 都 有 效 的 HIML: 


Qusing (Html.BegqlInEorm() ) 


| 
<h2>L1ist your emalil address (es)</h2> 
foreach (var emall in Model .Emal1s) 
{ 
<input type="text"™" name="emal1" value="Q@emalil™" /> 
<br /> 
} 
<input type="submit™ value="Send™ /> 
} 
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必须 处 理 在 表单 中 所 键入 的 email 地 址 的 控制 器 方法 的 预计 签名 是 什么 ? 是 下 面 这 个 : 


public ActionResult Emalils (IList<String> emall) 


{ 


} 


3-4 显示 出 ， 正 是 由 于 有 了 默认 绑 定 器 类 ， 一 个 字符 串 数组 就 可 以 正确 地 传递 给 该 


[ActionName("Emails")] 


[HttpPost] 
public ActionResult EmailsForPost(IList<strineg> email) 
{ = * email {string[5]} 


// Name of list parameter MUST be “email™” to mat| My [swing strinal5lr field in the view. 
// Either to call a single input field “emails” or @ [0 "admin@contoso, com' "email™. 
/i MUST use PREFIX to decouple names. 


Var model = new EmailsViewtiodel { Emails = defaultf @ [4] &*™ 
return View(model)}; 


图 3-4 ”一 个 已 提交 的 字符 串 数组 


正如 将 在 第 4 草 “ 输 入 表单 ”中 详尽 讨论 的 ， 当 你 使 用 HTML 表单 时 ， 你 很 可 能 需要 具 
有 两 个 方法 : -个 处 理 视图 的 显示 (GET 动词 ), 为 一 个 处 理 将 数据 发 送 到 视图 的 情况 。HttpPost 
和 HttpGet 特性 使 你 能 够 将 指定 方法 处 理 相同 操作 名 称 的 情形 标记 出 来 。 下 面 是 该 示例 的 完 


它 使 用 了 两 种 不 同 的 方法 处 理 GET 和 POST 的 情况 : 


[ActionName ("Emalls")] 


[HttpGet] 
Public ActionResult EmailForGet (IList<String> emalls) 


{ 


// Input parameters 


var defaultEmails = new[] { "admin@contoso.com™, ™™, nn wm nm )}; 
1f (emalils == null]l) 
emalls = defaultEmalls; 
1f (emalils.Count == 0) 
emalls = defaultEmaills; 
Var model = new EmalilsViewModel {Emails = emalls}; 


return View (model):; 


[ActionName ("Emails"™)] 
[HLLPPost 1 
public ActionResult EmallForPost (IList<String> emalil) 


{ 
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rr rr 
Fr 


var defaultEmails = new[] { "admin@contoso.com", 


Var model = new EmallsViewModel { Emalls = defaultEmails, ReglisteredEmails 


= emall }; 
return View (model); 


} 
下 面 是 图 3-5 中 所 呈现 的 视图 的 完整 Razor 标记 : 


全 看 http://localhost:3195/complex/emails 


Ihost 


Emails submitted 


"agmin 人 他 Ocontoso.com 
= foo@contoso.com 


图 3-5 POST 之 后 呈现 的 页 面 


model BindingFun.ViewModels.Complex.EmalilsViewModel 


<h2>L1ist your email address (es) </h2> 
Qusing (Html .BeginForm()) 


{ 
foreach (var emall in Model .Emalls,) 
{ 
<input type="text"™" name="emal1" Value="aemal1" /> 
<br /> 
} 
<input type="submit"™ Value="Send" /> 
} 
<hr /> 
<h2>Emails submitted</h2> 
<ul> 
Qforeach (var emall in Model .RegisteredEmalils) 
{ 
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1f (String.IsNullorwhitespace (emal1) ) 
{ 


continue: 


} 
<li>@emall</11> 


} 
</ul> 


最 后 ， 为 了 保证 值 的 集合 能 够 传递 到 控制 嚣 方法， 你 需要 确保 具有 相同 ID 的 元 素 都 被 
发 送 到 啊 应 流 。 然 后 ， 该 了 DD 必须 依据 绑 定 器 的 第 规 规则 匹配 到 控制 部 的 方法 签名 。 

如 果 是 集合 的 情况 , 名 字 之 间 所 需 的 匹配 会 使 你 不 得 不 违背 基本 的 命名 规则 。 在 视图 中 ， 
你 拥有 输入 字段 并 希望 调用 它们 ， 比 如 ，email 使 用 的 是 单数 形式 。 当 你 命名 控制 器 中 的 参数 
时 ， 由 于 你 要 得 到 的 是 集合 ， 因 此 你 可 能 会 将 其 命名 为 emails 这 一 复数 形式 。 然 而 ， 你 不 得 
不 至 始 至 终 要 么 使 用 email 要 么 使 用 emails。 变 通 办 法 将 在 稍 后 我 们 介绍 到 考虑 模型 绑 定 器 
的 目 定 义 方 面 时 谈 到 。 

6. 绑 定 复杂 类 型 的 集合 

默认 绑 定 器 也 可 以 处 理 集合 中 包含 复杂 类 型 的 情况 ， 甚 至 是 如 下 所 示 的 葡 套 情形 : 

[ActionName ("Countries"™)] 

[HttpPost] 


public ActionResult CountriesForPost (IList<Country> country) 
{ 


} 
举例 来 说 ， 请 思考 下 面 Country 类 型 的 定义 : 


public class Country 


{ 
public Country () 
{ 
Detalils = new CountryInfo(); 
} 
public String Name { get; set; } 
Public CountryInfo Details { get; set; } 
} 
Public class CountryInfo 
{ 
public String Capital { get; set; } 
public String Continent { get; set; } 
} 
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要 使 模型 绑 定 成 功 地 进行 ， 你 真正 需要 做 的 就 是 对 标记 中 的 ID 使 用 渐进 式 索引 。 生 成 


的 模式 是 prefix[index]。Prefix 所 代表 的 属性 会 匹配 控制 器 方法 的 签名 中 的 形 参 名 称 : 


Qusing (Htm1l.BeglInForm() ) 


{ 
<h2>Select Your favorite countries</h2> 
var index = 0; 
foreach (var country in Model.CountryList) 
{ 
<fieldset> 
<dliv> 


<b>Name</b><br /> 
<input type="text" 
name="countries [@index] .Name" 
value="(country.Name™" /><br /> 
<b>Capital</b><br /> 
<input type="text" 
name="country[Q@index] .Details.Capital" 
value="Qcountry.Details.Capital™. /><br /> 
<b>Continent</b><br /> 
Qf 
var id = String.Format ("country[{0}] .Details.Continent", 


indext+t+)，; 


} 
QHtml .TextBox (1d, country.Details.Continent) 
<br /> 
</dliv> 

</fieldset> 

} 

<input type="submit"™ value="Send™ /> 

} 


索引 是 数值 型 ， 从 0 开始 渐进 的 。 在 这 个 示例 中 ， 为 每 个 指定 的 默认 国家 构建 用 户 界 面 
块 。 如 果 有 固定 数量 的 用 户 界 面 块 要 呈现 ， 可 以 使 用 静态 索引 。 
<input type="text" 


name="country[0] .Name" 
value="Q@country.Name™" /> 


<input type="text" 
name="country[l| .Name"™ 
Value="acountry.Name" /> 


注意 系列 中 的 间 隐 (比如 0 与 2 之 间 ) 会 俘 止 解析 过 程 ， 你 重新 获得 的 是 从 0 到 这 个 则 隐 
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的 数据 类 型 序列 。 


数据 的 提交 也 会 正常 执行 。 控 制 器 类 上 的 POST 方法 只 会 接收 相同 层级 的 数据 , 如 图 3-6 


所 示 。 


[HttpPost] 
[ActionName(™“Countries™ )] 
public ActionResult CountriesForPost(IList<Countryy country') 
{ 5 只 countm Count=3 
2 bar defaultCountries = GetDefaultCountries()]| 田 多 [0] {BindingFun.InputModels,.Country} 
日 Y nng nnpu Vose .Coun 
Var model = new CountriesViewihodel ;i : 
{ 
CountryList = defaultCountries, 
SelectedCcountries = country 
}; 


return View(model); 


图 3-6 提交 到 该 方法 的 复 洒 类 型 和 棒 套 类 型 


如 有 果 提 交 的 值 在 映射 到 预期 类 型 层级 的 过 程 中 示 到 厅 烦 ， 不 用 担心 ， 可 以 考虑 使 用 目 定 


义 的 模型 绑 定 器 。 
7. 绑 定 上 传 文件 的 内 容 


表 3-1 表明 上 传 的 文件 也 可 以 成 为 模型 绑 定 的 主体 。 默 认 绑 定 器 通过 匹配 与 参数 名 称 一 


起 上 传 的 输入 文件 元 素 的 名 称 来 实现 绑 定 。 但 是 参数 (或 参数 类 型 上 的 属性 ) 必 须 声 
HttpPostedFileBase 类 型 : 


public class UserData 


t 

public string Name { get; set; } 

public string Email { get; set; } 

public HttpPostedFileBase Picture { get; set; } 
} 


下 面 的 代码 显示 了 将 上 传 文件 保存 在 服务 器 计算 机 中 某 个 位 置 的 控制 器 操作 的 


能 实现 : 


Public ActionResult Add (UserData inputModel]) 
{ 
var destinationFolder = Server.MapPath("/Users"); 
Var postedFile = inputModel .Picture; 
if (postedrFile.ContentLength > 0) 
{ 
Var fileName = Path.GetrFrileName (postedFile.FileName); 
var path = Path.Combine (destinationFolder, fileName); 
postedFile.saveaAs (path); 


明 为 


-种 可 
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return View({(); 


} 


默认 情况 下 ， 任 何 ASPNET 请 求 都 不 能 超过 4MB。 这 个 数字 包含 了 所 有 的 上 传 、 标 头 、 
正文 以 及 正在 传输 的 任何 内 容 。 可 以 通过 web.config 文件 中 httpRuntime 部 分 的 
maxRequestLength 条 目 来 配置 各 个 级 别 的 上 传 装 值 : 

<SYStLem -WebD> 


<httpRuntime maxReduestLendth="6000" /> 
</system.web> 


很 明显 ,请求 越 大 ,可 能 你 留 给 黑客 攻击 网 站 的 空间 也 越 大 。 同 时 请 记 住 在 托管 方案 中 ， 
如 条 主机 设置 了 域 级 别 的 不 同 限 制 ， 并 锁定 了 较 低 级 别 的 maxRequestLeneth 属性 ， 那 么 你 的 
应 用 程序 级 别 的 议 症 可 能 会 似 忽 略 。 
那么 上 传 多 个 文件 的 情形 呢 ? 只 要 上 传 的 整体 规模 与 当前 的 最 大 请 求 长 度 相 符 ， 你 是 可 
以 在 单个 请 求 中 上 传 多 个 文件 的 。 然 而 ， 需 要 考虑 的 是 Web 浏览 器 并 不 知道 如 何 上 传 多 个 文 
件 。Web 浏览 器 能 做 的 只 是 上 传 一 个 文件 ， 并 且 只 能 通过 一 个 file 类 型 的 输入 元 紊 引用 它 才 
行 。 要 上 传 多 个 文件 ， 可 以 借助 于 一 些 客户 端 专用 组 件 ， 或 在 表单 中 放置 多 个 <input> 元 素 。 
如 果 使 用 多 个 正确 命名 的 <input> 元 素 ， 一 个 如 下 所 示 的 类 会 将 它们 全 部 绑 定 : 
public class UserData 
public String Name { get; set; } 
public String Emall { get; set; } 
public HttpPostedFileBase Picture { get; set; } 
public IList<HttpPostedFileBase> AlternatePictures { get; set; } 
} 


这 个 类 表示 了 提交 的 用 于 新 用 户 的 数据 ， 其 中 带 有 一 个 默认 图 片 和 一 系列 备用 图 片 。 下 
面 是 备用 图 片 的 标记 : 


<input type="file" i1d="AlternatePictures[0]" name="AlternatePictures[0]" /> 
<input type="file" i1d="AlternatePictures[1]" name="AlternatePictures[1]" /> 


ASPNET 应 用 程序 账户 
在 Web 服务 器 上 创建 文件 通常 不 是 依赖 默认 权限 集 就 可 以 完成 的 操作 。 所 有 ASPNET 
应 用 程序 都 是 在 那些 为 应 用 程序 所 属 的 应 用 程序 池 提 供 服 务 的 工作 进程 账户 下 运行 的 。 在 正 


常情 况 下 ， 这 个 账户 是 NETWORK SERVICE， 而 它 并 未 获得 创建 新 文件 的 权限 。 这 就 是 说 
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为 了 保存 文件 ， 你 必须 更 改 ASPNET 应 用 程序 使 用 的 账 尸 ， 或 者 提升 默认 账户 的 权限 。 
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多 年 来 ， 应 用 程序 池 的 标识 一 直 是 一 个 固定 的 标识 一 一 也 即 前 面 所 说 的 NETWORK 
SERVICE 账户 ， 它 在 微软 Windows 中 是 一 个 权限 相对 较 低 的 内 置 标识 。 它 最 初 作为 出 色 的 
安全 措施 是 受 欢迎 的 ， 但 是 到 后 来 ， 使 用 单个 账户 来 应 对 潜在 的 众多 并 发 运行 服务 的 做 法 引 
发 了 很 多 问题 ， 与 它 所 解决 的 问题 相 比 就 有 些 得 不 偿 失 了 。 


总 而 言 之 ， 在 相同 账户 下 运行 的 服务 可 能 会 相互 和 干涉。 为 此 ， 在 Internet Information 
Services 7.5 中 ， 工 作 进 程 默 认 会 在 唯一 标识 下 运行 ， 这 些 唯 一 标识 是 目 动 为 每 个 新 创建 的 应 
用 程序 池 创 建 的 .其 搬 层 拉 术 是 虚拟 账户 (Virtual Accounts), 明 前 受到 Windows Server 2008 R2 
和 Windows 7 以 及 更 高 版 本 的 文 持 。 更 多 有 关 信 息 , 请 查看 http://technet.microsoft.comy/library/ 
ddqd348336.aspX。 


3.2.3 ”默认 绑 定 器 的 可 自 定 义 方 面 
自动 绑 定 源 于 约定 优 于 配置 的 方式 。 但 有 时 候 这 些 约定 包含 不 好 的 意外 情况 。 如 果 出 于 
某 些 原 因 你 失去 了 对 所 提交 数据 的 控制 (比如 ， 数 据 被 算 改 的 情况 )， 可 能 会 导致 不 希望 发 生 
的 绑 定 ; 事实 上 ， 任 何 发 送 的 键 / 值 对 都 会 被 绑 定 。 出 于 此 原因 ， 你 应 该 考虑 使 用 Bind 特性 
对 绑 定 过 程 的 某 些 方面 进行 自 定 义 。 
1. Bind 特性 
Bind 特性 包含 三 个 属性 ， 如 表 3-2 中 所 示 。 
表 3-2 BindAttribute 类 的 属性 
属 性 描 述 


Prefix 解析 的 必须 在 提交 值 名 称 中 发 现 的 前 级 。 其 默认 值 是 空 
Exclude 获得 或 设置 不 允许 绑 定 的 用 逗号 分 隔 的 属性 名 称 列表 
Include 获得 或 设置 允许 绑 定 的 用 去 号 分 隔 的 属性 名 称 列表 


需要 将 Bind 特性 应 用 在 方法 签名 的 参数 上 。 
2. 创建 属性 日 名 单 


前 面 说 过 ， 当 你 有 复杂 类 型 的 时 候 ， 上 自动 模型 绑 定 是 有 潜在 风险 的 。 在 这 种 情况 下 ， 只 
要 默认 绑 定 器 在 提交 值 中 找到 了 [匹配 项 ， 它 就 会 试图 把 所 有 的 公共 属性 填 入 复 洒 类 型 中 。 这 
可 能 最 终 导 致 服务 器 类 型 充满 了 意料 之 外 的 数据 ， 尤 其 是 在 请 求 被 算 改 的 情况 下 。 为 了 避免 
此 种 情况 的 出 现 ， 可 以 使 用 Bind 特性 上 的 Include 属性 ， 创 建 一 个 可 接受 的 属性 白 名 单 ， 如 
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下 所 示 : 
public ActionResult RepeatonlyText ( [BlInd(Include = "text") ] RepeatText 
inputModel) 
{ 
} 


RepeatText 类 型 的 绑 定 将 限于 所 列 出 的 属性 (对 于 上 面 的 示例 ， 只 有 Text 属性 被 允许 )。 
其 他 的 所 有 属性 均 不 会 绑 定 ， 而 是 采用 在 RepeatText 实现 中 分 配给 它们 的 默认 值 。 多 个 属性 
之 间 以 逗号 分 隔 。 


3. 创建 属性 黑 名 单 


Exclude 特性 采用 相反 的 逻辑: 它 罗 列 出 了 必须 从 绑 定 中 排除 的 属性 。 除 了 那些 显 式 列 
出 的 属性 ， 其 他 属性 都 会 被 绑 定 : 
public ActionResult RepeatonlyText ([Bind (Exclude = "number") ] RepeatText 


inputModel) 
{ 


} 


可 以 在 相同 的 特性 中 同时 使 用 Include 和 Exclude， 如 果 这 样 能 够 使 你 更 好 地 定义 要 绑 定 
的 属性 集 的 话 。 例 如 ， 如 果 两 个 特性 引用 相同 的 属性 ， 那 么 Exclude 会 生效 。 


4. 加 前 组 的 参数 别名 


默认 的 模型 绑 定 器 会 强制 你 将 请 求 参数 (比如 ， 表 单 和 查询 字 符 虽 字段 ) 合 名 为 在 目标 操 
作 方 法 上 与 形 参 相 匹配 的 指定 名 称 。 使 用 Prefix 特性 ， 可 以 更 改 此 规则 。 通 过 设置 Prefix 特 
性 指示 模型 绑 定 器 : 请 求 参 数 要 [匹配 形 参 的 前 经， 而 不 是 形 参 名 称 。 总 之 ， 别 名 对 于 特性 来 
说 应 该 是 一 个 更 好 的 名 称 。 请 思考 下 面 的 示例 : 


[HttpPostl 

[ActionName ("Emalils"™)] 

public ActionResult EmailForPost ([Bind (Prefix = "emall") ]IList<Sstring> 
emalls) 


{ 


} 


为 了 成 功 填充 emails 参数 ， 你 需要 提交 名 称 是 email 而 非 emails 的 字段 。Prefix 特性 对 
于 POST 方法 具有 特殊 意义 ， 它 解决 了 上 述 命名 规则 和 参数 集合 的 问题 。 
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最 后 ， 需 要 注意 的 是 如 果 指 定 了 前 级 ， 那 么 它 将 成 为 强制 性 的 ， 随 后 ， 未 添加 前 级 的 名 
称 字 段 都 不 会 被 绑 定 。 

注意 : 

为 特性 Prefix 选择 的 名 称 确实 并 非 它 所 应 对 情形 的 真实 说 明 。 大 家 都 认为 别名 本 来 可 以 
是 一 个 更 好 的 名 称 。 但是， 现在 想 改 变 太 迷 了 |! 


3.3 ”高 级 模型 绑 定 


到 目前 为 止 ， 我 们 探究 了 默认 模型 绑 定 器 的 作用 。 默 认 绑 定 器 发 挥 了 出 色 的 作用 ， 但 它 
是 一 个 通用 工具 ， 旨 在 通过 某 种 通用 方式 处 理 最 常见 的 类 型 。Bind 特性 使 你 对 绑 定 过 程 有 了 
更 多 的 控制 , 但 它 的 能 力也 受到 了 一 些 合理 的 限制 。 如 果 想 要 实现 对 绑 定 过 程 的 完全 控制 权 ， 
则 需要 创建 针对 不 同类 型 的 目 定 义 绑 定 需 。 
3.3.1 自 定 义 类 型 绑 定 器 

只 有 一 个 重要 原因 使 你 愿意 创建 自 定义 的 绑 定 器 : 即 默 认 绑 定 器 仅 限 于 处 理 提交 值 与 模 
型 属性 之 间 一 对 一 的 对 应 关系 。 

然而 有 时 候 ， 目 标 模型 有 着 与 表单 字段 所 表示 的 不 同 的 粒度 。 典 型 的 例子 是 ， 当 你 使 用 
多 个 输入 字段 来 让 用 户 输 入 单个 属性 内 容 的 时 候 ， 例 如 ， 不 同 的 输入 字段 为 日 、 月 和 年 ， 然 
后 映射 到 一 个 单一 的 DateTime 值 。 

1. 自 定义 默认 绑 定 器 

要 从 头 开始 创建 一 个 自 定义 的 绑 定 器 ,你 需要 实现 IModelBinder 接口 。 想 要 实现 对 绑 定 
过 程 的 完全 控制 ， 推 荐 实现 这 个 接口 。 比 如 ， 如 果 只 需要 保持 默认 的 功能 ， 并 且 仅仅 强制 绑 
定 器 使 用 一 个 用 于 指定 类 型 的 非 默认 构造 函数 ， 那 么 从 DefaultModelBinder 继承 是 最 好 的 办 
法 。 下 面 是 要 遵循 的 架构 : 


public RepeatTextModelBinder : DefaultModelBinder 


{ 
protected override object CreateModel ( 
ControllerContext controllercontext, 
ModelBindingContext bindingContext, 
Type modelType) 
{ 
return new RepeatText( ... ); 
} 
} 
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单纯 重 写 默认 绑 定 器 的 另 一 个 音 见 情形 是 ， 当 你 所 需 的 只 是 针对 特定 类 型 进行 验证 的 能 
力 时 。 在 这 种 情况 下 ， 你 只 需要 重 写 OnModelUpdated 并 插入 你 自己 的 验证 逻辑 ， 如 下 所 示 : 
protected override Vold OnModelUpdated (ControllerContext controllerContext, 
ModelBindingContext bindingContext) 

{ 

Var ob] = bindingContext.Model as RepeatText; 

1f (ob] == null) 

return; 


// Apply validation logic here for the whole model 
1f (String.IsNullorEmpty (ob] .Text)) 
{ 
bindingContext.Modelstate.AddModelError ("Text", ...); 
} 


} 


如 果 希 望 各 个 属性 的 所 有 验证 都 保持 在 一 个 位 置 , 则 可 以 重 写 OnModelUpdated。 如 果 更 
倾 问 于 单独 放置 验证 属性 ， 则 可 以 借助 于 OnPropertyValidating。 


重要 提示 : 

当 绑 定 发 生 于 复杂 类 型 时 ， 默 认 绑 定 器 会 直接 将 匹配 的 值 复制 到 属性 中 。 如 果 其 中 的 某 
些 值 使 复杂 类 型 的 实例 处 于 无 效 状态 的 话 ， 你 无 法 拒绝 匹配 它们 。 

自 定 义 绑 定 器 可 以 集成 一 些 逻 辑 来 检查 分 配给 属性 的 值 ， 并 且 向 控制 器 方法 表明 产生 了 
错误 ， 或 者 通过 用 默认 值 替换 无 效 值 从 而 大 大 减轻 错误 程度 。 

虽然 这 种 方法 可 以 使 用 ， 但 它 并 没有 被 普遍 采用 ， 这 是 因为 在 ASPNET MVC 中 有 更 强 
大 的 选项 可 用 来 处 理 输入 表单 中 所 有 的 数据 验证 。 这 也 是 我 将 在 第 4 章 讨论 的 话题 。 

2. 从 头 开始 实现 模型 绑 定 器 

IModelBinder 接口 的 定义 如 下 : 

public interface IModelBinder 

{ 

Object BindModel (ControllerContext controllerContext, 


ModelBindingContext bindingContext); 
} 


下 和 面 是 直接 实现 IModelBinder 接口 的 目 定义 绑 定 亏 的 框 洪 。 该 模型 绑 定 器 是 为 一 个 特定 
的 类 型 编写 的 本 例 中 为 MyComplexType: 


public class MyComplexTypeModelBinder : IModelBinder 
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public Object BindModel (ControllerContext controllerContext, 
ModelBindingContext bindingContext) 


{ 
if (bindingContext == null) 
throw new ArgumentNullException ("bindingContext"); 


// Create the model instance (using the ctor you like best) 
Var ob] = new MyComplexType (); 


// Set properties reading values from reglistered value providers 
ob] .SomeProperty = FromPostedData<string> (bindingContext, 
"SomeProperty"); 
return ob]; 
} 


// Helper routine 
private T FromPostedData<T> (ModelBindingContext context, String key) 


{ 
// Get the value from any of the input collections 


ValueProviderResult result; 
context .ValueProvider.TryGetValue (key, out result);} 


// Set the state of the model property resulting from value 
context .Modelstate.SsetModelValue (key, result); 


// Return the value converted (if possible) to the target type 
return (T)} result.ConvertTo (typeof ( 工 ) ) 7 
} 
BindModel 类 的 结构 非常 简单 。 首 先 创 建 一 个 要 用 到 的 BindModel 类 的 新 实例 。 为 此 ， 
可 以 使 用 喜欢 的 构造 函数 (或 工厂 ) 并 且 执 行 上 下 文 所 需 的 目 定 义 初始 化 。 接 着 ， 只 需要 为 刚 
创建 的 实例 的 属性 填 入 从 提交 数据 中 读 取 或 推测 的 值 。 在 前 面 的 代码 片段 中 ， 假 设 仅仅 复制 
了 默认 提供 程序 的 行为 ， 并 且 从 基于 匹配 属性 名 称 的 已 注册 值 提供 程序 中 读 取 值 。 很 明显 ， 
这 就 是 你 需要 添加 日 己 的 人 逻辑 的 地 方 ， 来 解释 和 传递 由 请 求 上 传 的 内 容 。 
请 记 住 ， 编 写 模型 绑 定 器 时 ， 你 并 不 局 限于 仅 从 提交 数据 中 获取 用 于 模型 的 信息 ， 虽 然 
这 代表 了 大 多 数 和 常见 情形 。 可 以 从 任何 位 置 (比如 从 ASPNET 缓存 和 会 话 状态 中 ) 获 取信 息 ， 
解析 并 将 它 存储 在 模型 中 。 
注意 : 
除了 默认 绑 定 器 ，ASPNET MVC 还 带 有 两 个 内 置 的 绑 定 器 。 这 两 个 额外 的 绑 定 器 分 别 
在 提交 数据 是 Base64 流 (ByteArrayModelBinder 类 型 ) 以 及 文 件 内 容 正 在 上 传 
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(HttpPostedFileBaseModelBinder 类 型 ) 时 自动 选用 。 

3. 注册 自 定义 绑 定 右 

可 以 将 模型 绑 定 器 与 其 目标 类 型 进行 全 局 关联 或 局 部 关联 。 对 于 全 局 关联 ， 所 有 用 于 某 
类 型 的 模型 绑 定 右 的 匹配 都 会 通过 已 注册 的 目 定义 绑 定 右 加 以 解析 。 而 对 于 局 部 关联 ， 绑 定 
会 应 用 于 控制 器 方法 中 茶 个 参数 的 一 次 匹配 。 

全 局 关联 在 global.asax 文件 中 进行 定义 ， 如 下 所 示 : 


Vold Application start() 
{ 


ModelBinders.Binders[typeof (MyComplexTypeModelBinder)] = 
new MyCustomTypeModelBinder (); 
} 


局 部 关联 要 用 下 面 的 语法 : 


Public ActionResult RepeatText ( 
[ModelBinder (typeof (MyComplexTypeModelBinder))] MyComplexType info) 
{ 


} 


局 部 绑 定 龙 忆 十 优先 于 全 局 定义 的 旨 定 右 。 
可 以 从 前 面 代码 的 Application_Start 中 清晰 地 获知 ， 可 以 注册 多 个 绑 定 器。 如 果 震 要 ， 
还 可 以 车 写 默 认 的 绑 定 右 : 


ModelBinders.Binders.DefaultBinder = new MyNewDefaultBinder ();} 


但 是 ， 修 改 默认 绑 定 峰 会 对 应 用 程序 的 行为 产生 较 大 影响 ， 因 此 在 决定 修改 之 前 需要 仔 
细 其 | 酌 ]。 
3.3.2 ”DateTime 模型 绑 定 器 示例 

在 输入 表单 中 ， 用户 键入 日 期 是 常 有 的 事 。 有 时 你 还 可 以 使 用 jQuery 用 户 界 面 ， 让 用 户 
从 图 形 日 历 中 选择 日 期 。 如 果 在 最 新 的 浏览 器 上 使 用 HIMLS 标记 ， 日 历 将 自动 提供 。 所 选 
择 的 日 期 会 转换 成 一 个 字符 串 ， 保 存 到 一 个 文本 框 中 。 当 表单 回 传 时 ， 日 期 字符 串 被 上 传 ， 
默认 绑 定 器 会 试图 将 其 解析 成 DateTime 对 象 。 

在 其 他 情形 中 ， 你 可 能 会 决定 将 日 期 拆 分 成 三 个 不 同 的 文本 框 ， 分 别 为 日 、 月 和 年 。 它 
们 分 别 作为 请 求 中 的 不 同 值 上 传 。 其 结果 是 默认 绑 定 器 只 能 单独 管理 它们 ; 从 日 、 月 和 年 的 
值 中 创建 有 效 DateTime 对 象 的 任务 由 控制 器 承担 。 有 了 自 定义 的 默认 绑 定 器 , 就 可 以 使 用 控 


第 3 章 ”模型 绑 定 架 构 


制 器 中 的 代码 ， 同 时 享受 拥有 控制 器 方法 以 下 签名 的 乐趣 : 

public ActlIonResult MakeReservation (DateTime theDate) 

我 们 看 看 如 何 设置 一 个 更 接近 现实 的 模型 绑 定 器 的 示例 。 

1. 显示 数据 

我 们 接 下 来 要 考虑 的 示例 视图 显示 了 组 成 日 期 项 的 三 个 文本 框 ， 以 及 一 个 提交 按钮 。 你 
输入 一 个 日 期 , 系统 会 计算 已 经 过 了 多 少 天 或 还 有 多 少 天 才 到 你 指定 的 那 一 天 。 下 面 是 Razor 
标记 : 


lmodel DateEditorResponseViewModel 
@section titlef 
@Model .Title 


Qusing (Html .BeginForm()) 


{ 
<fieldset> 
<legend>Date Editor</legend> 
<dlv> 
<table><tr> 
<td>l@DateHelpers.InputDatel("theDate", Model.DefaultDate)</td> 
<td><input type="submit™ wvalue="Find out more™ /></td> 
</tr></table> 
</dliv> 
</fieldset> 
} 
<hr /> 


@DateHelpers.Distance (Model .TimeToToday) 
可 以 看 到 ， 我 使 用 了 两 个 自 定义 帮助 器 来 更 好 地 封装 一 些 视图 代码 的 呈现 。 下 面 是 如 何 
呈现 日 期 元 系 的 代码 : 


Qhelper InputDate (String name, DateTime? theDate) 
{ 


String day="", month="™", year="",} 
1f (theDate.HasValue) 


{ 
day = theDate.Value.Day.Tostring(); 
month = theDate.Value.Month.TosString (); 
year = theDate.Vvalue.Year.ToSsString (); 

} 
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<table cellpadding="0"> 
<thead> 
<th>DD</th> 
<th>MM</th> 
<th>YYYY</th> 
</thead> 
<tr> 
<td><input type="number™. name="@ (name + ".day"™)" 
value="@day" style="width:30px"™" /></td> 
<td><input type="number" name="Q@ (name + ".month™)™" 
value="@month™" stylje="width:30px"></td> 
<td><input type="number" name="@ (name + ".year™)" 


value="@year™ style="wlidth:40px"™" /></td> 
</tr> 
</table> 


} 


3-7 显示 了 输出 结果 。 


介 httpi/ /localhost:3195,/date/editor 
七 localhost 


Date Editor 


DD MM YYYY 


2 MY Lmao | 


图 3-7 一 个 将 日 期 输入 文本 拆 分 为 日 -月 -年 元 素 的 示例 视图 
2. 控制 器 方法 


3-7 中 的 视图 由 下 面 的 控制 器 方法 提供 服务 和 处 理 : 


public class DateController : Controller 
{ 

[HttpGetl] 

[ActionName ("Editor"™)] 

public ActionResult EditorForGet () 

{ 


var model = new EditorViewModel () ， 
return View (model); 
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[ HttpPost] 
[ActionName ("Editor"™)] 
public ActionResult EditorForPost (DateTime theDate) 


| 
Var model = new EditorViewModel () :; 
1f (theDate != default (DateTime)) 
{ 
model .DefaultDate = theDate; 
model.TimeToToday = DateTime.Today.Ssubtract (theDate); 
} 
return View (model); 
} 


} 
日 期 回 传 后 ， 控 制 旧 操作 会 计算 出 与 当前 日 期 的 差 弄 ， 并 通过 使 用 一 个 TimeSpan 对 象 
将 结果 存储 在 视图 模型 中 。 下 面 是 该 视图 模型 对 象 : 


public class EditorViewModel : ViewModelBase 


{ 
public EditorViewModel () 
{ 
DefaultDate = null; 
TimeToToday = null; 
} 
public DateTime? DefaultDate { get; set; } 
public Timespan? TimeToToday { get; set; } 
} 


还 待 探究 的 是 将 三 个 不 同 的 独立 上 传 值 转换 成 一 个 DateTime 对 象 的 执行 代码 。 
3. 创建 DateTime 绑 定 器 


DateTimeModelBinder 对 象 的 结构 与 我 前 面 摘 述 过 的 框架 没有 太 大 区 别 。 只 是 它 是 为 
DateTime 类 型 量 身 定做 的 。 


public class DateModelBinder : IModelBinder 


{ 
public Object BindModel (ControllerContext controllerContext, 


ModelBindingContext bindingContext) 


1f (bindingContext == null) 
{ 


throw new ArgumentNullException ("bindingContext"); 
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// This will return a DateTime object 
Var theDate = default (DateTime); 


// Try to read from posted data. xxx.Day |xxx.Month |xxx.Year 15 assumed. 
var day = FromPostedData<int> (bindingContext, "Day™); 

Var month = FromPostedData<int> (bindingContext, “Month"); 

Var year = FromPostedData<int> (bindingContext, "Year") : 


return CreateDateorDefault (year, month, day, theDate); 


// Helper routines 
private static TFromPostedData<T> (ModelBindingContext context, String 1d) 


{ 


1f (String.IsNullorEmpty (1d)) 
return default ( 工 ) ， 


// Get the Value from any of the input collections 
Var key = String.Format ("{0}.{1}", context.ModelName, 1d); 
Var result = context .ValueProvlder .GetValue (key); 
1f (result == null && Context .FallbackToEmptyPrefix) 
{ 

// Try without prefix 

result = context.ValueProvider.GetValue (1d); 

1f (result == null]l) 

return default (T}; 


// Set the state of the model property resulting from Value 
context .ModelState.SetModelValue (1d, result); 


// Return the Value converted (if possible) to the target type 
T valueToReturn = default (T); 
try 
{ 
valueToReturn = (T)}result.cCconvertTo (typeof (T)); 
} 
catch 
{ 
} 


return valueToReturn:; 
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private DateTime CreateDateorDefault (Int32 year, Int32 month, Int32 day, 
DateTime? defaultDate) 


{ 
var theDate = defaultDate ?2 default (DateTime)}); 
try 
{ 
theDate = new DateTime (year, month, day); 
} 
catch (ArgumentoutofRangeException e) 
{ 
} 
return theDate; 
} 


} 


绑 定 孝 对 这 三 个 输入 元 素 的 命名 规则 做 了 一 些 假设 。 尤 其 是 ， 它 需要 这 些 元 素 被 命名 为 
日 、 月 和 年 ， 并 可 能 以 模型 的 名 称 为 前 绥 。 这 是 对 前 绥 的 文 持 ， 以 便 在 同一 视图 中 有 多 个 日 
期 输入 框 ， 且 不 发 生 冲 突 。 

要 使 目 定 义 绑 定 圳 可用， 你 只 需要 对 它 进行 全 局 或 局 部 注册 。 下 面 展示 了 如 何 使 用 一 种 
特定 的 控制 需 方 法 来 实现 注册 : 


[HLLPPost |】 

[ActionName ("Editor™)] 

public ActionResult EditorForPost([ModelBinder (typeof (DateModelBinder))] 
DateTime theDate) 


| < er http:/ /localhost3195,/date/edrtor 


起 localhost 


Date Editor 


DD MM YYYY 


Br a or | town 


lt will be in 9 days 


图 3-8 ”使 用 自 定义 类 型 绑 定 器 处 理 日 其 
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3.4 ”本 章 小 结 


在 ASPNETMVC 和 ASPNET Web Forms 中 ,提交 的 数据 会 进入 HITP 数据 包 中 一 并 提 
交 ， 并 映射 到 Request 对 象 上 的 各 种 集合 。 为 了 同 开 发 人 员 提 供 民 好 的 服务 ，ASPNET 随后 
会 尝试 以 更 有 效 的 方式 公开 这 些 内 容 。 

在 ASPNET Web Forms 中 ， 内 容 被 解析 并 传递 给 服务 器 控件 ， 而 在 ASPNET MVC 中 ， 
内 容 梓 绑 定 到 所 选 控制 器 方法 的 参数 。 将 提交 值 绑 定 到 参数 的 过 程 称 为 模型 绑 定 ， 古 通过 一 
个 已 注册 的 模型 绑 定 器 类 实现 的 。 模 型 绑 定 器 为 你 提供 了 将 表单 提交 值 反 序列 化 为 简单 类 型 
和 复杂 类 型 的 完全 控制 权 。 

在 功能 方面 ， 默 认 绑 定 器 的 使 用 是 对 开发 人 员 透 明 的 一 无 须 进 行 终端 操作 一 一 并 且 它 
保持 了 控制 器 代码 的 整洁 。 通 过 使 用 模型 绑 定 器 ， 包 括 自 定义 绑 定 器 ， 使 控制 器 代码 摆脱 了 
对 ASPNET 内 在 对 象 的 依赖 ， 因 而 使 其 变 得 更 整洁 和 易于 测试 。 

模型 绑 定 器 的 使 用 与 提交 和 输入 表单 紧密 相关 。 在 第 4 章 中 ， 将 讨论 输入 表单 、 输 入 建 
模 和 数据 验证 几 个 方面 的 内 容 。 


不 管 你 能 做 什么 ， 或 者 梦想 做 成 什么 ， 开 始 去 做 吧 ， 
一 一 应 余天 所 玛 德 


经 典 ASPNET 的 编程 模型 是 基于 在 回 传 间 保持 状态 的 假设 的 。 在 HITP 协议 级 别 却 并 非 
如 此 ， 但 是 通过 使 用 页 面 视 图 状态 功能 和 针对 Web Forms 页 面 生 命 周 期 进行 一 些 处理 ， 就 可 
以 出 色 地 模拟 出 这 个 假设 。 视 图 状态 ， 这 个 大 家 往往 避 而 远 之 的 东西 ， 却 是 在 ASPNET 中 建 
立 有 状态 编程 模型 的 大 功臣 ， 而 该 编程 模型 是 ASPNET 取得 成 功 且 迅速 普及 的 一 个 关键 。 数 
据 输入 是 服务 器 控件 真正 发 光 发 热 的 领域 ， 它 们 的 回 传 和 视图 状态 系统 开销 使 你 避免 了 大 量 
的 工作 。 服 务 器 控件 也 为 你 提供 了 一 个 强大 的 用 于 输入 验证 的 基础 架构 。 

如 条 对 Web Forms 及 其 服务 器 控件 已 经 非常 熟悉 ， 那 么 当 你 转 癌 ASPNET MVC 模型 时 
你 可 能 会 感到 震惊 。 在 ASPNET MVC 中 ， 与 Web Forms 相同 的 功能 是 要 借助 不 同 的 工具 集 
来 完成 的 。ASPNET MVC 框架 使 用 不 同 的 模式 ， 它 并 不 是 以 页 面 为 基础 的 ， 而 且 依 赖 一 个 
比 Web Forms 更 单薄 的 抽象 层 。 其 结果 是 ， 你 不 会 有 丰富 的 如 服务 器 控件 这 样 的 原生 组 件 来 
快速 配置 一 个 友好 的 用 户 界 面 ， 其 中 元 素 可 以 在 回 传 期 间 保留 它们 的 内 容 。 这 一 事实 看 似 导 
致 了 生产 效率 的 降低 ， 至 少 对 某 些 类 型 的 应 用 程序 来 说 是 这 样 的 ， 比 如 那些 很 大 程度 上 基于 
数据 输入 的 应 用 程序 。 

然而 ， 事 实 真 是 这 样 吗 ? 

确实 ， 在 ASPNET MVC 中 你 编写 的 代码 在 概念 和 实质 上 更 接近 于 底层 ; 因此， 它 用 到 
了 更 多 代码 行 ， 但 它 使 你 对 生成 的 HTML 和 运行 时 环境 的 实际 行为 有 了 更 多 的 控制 。 不 过 ， 
你 不 需要 一 切 从 头 开 始 编写 。 你 有 HIML 帮助 器 ， 可 以 自动 为 任何 简单 或 复杂 的 类 型 创建 简 
单 而 实用 的 视图 和 编辑 器 。 你 有 数据 批注 ， 可 以 用 声明 方式 设置 你 对 某 字段 的 内 容 及 其 显示 
行为 的 预期 。 你 有 模型 绑 定 器 , 可 以 将 提交 的 值 序 列 化 为 对 服务 器 端的 处 理 更 为 适用 的 对 象 。 
另外 ， 你 还 有 用 于 服务 器 和 客户 端 验证 的 工具 。 

本 章 旨 在 展示 如 何 通过 ASPNET MVC 中 的 表单 获得 输入 数据 ， 然 后 在 一 个 数据 持久 层 
对 其 进行 验证 和 处 理 。 
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注意 : 

用 于 输入 表单 的 基于 Ajax 的 解决 方案 日 益 受 到 人 们 的 重视 . 例如 , 向 用 户 显示 一 个 模 态 
对 话 框 ， 以 便 用 户 在 其 中 键入 输入 数据 这 一 情形 变 得 越 来 越 第 见 。 显 示 一 个 模 态 对 话 框 与 创 
建 一 个 单独 的 <div> 一 样 简 单 , 并 有 像 Twitter 引导 程序 或 jQuery UI 这 样 的 客户 端 框架 来 管理 
呈现 形式 。 但 是 就 提交 数据 而 言 ， 使 用 普通 的 FORM 提交 以 及 本 章 所 讨论 的 ASPNET MVC 
API 控制 下 的 全 部 或 部 分 页 面 刷 新 仍然 是 普遍 的 选择 。 田 一 个 选项 可 能 会 使 本 章 内 容 稍 显 无 
趣 ， 那 就 是 通过 使 用 纯 JavaScript 代码 自己 管理 HTTP POST.， 


4.1 数据 输入 的 一 般 模式 


输入 表单 围绕 两 个 主要 模式 : 编辑 -提交 模式 (Edit-and-Post) 和 选择 -编辑 -提交 模 式 
(Select-Edit-Post)。 前 者 会 显示 一 个 HTML 表单 ， 且 预期 用 户 来 填充 字段 并 在 完成 时 提交 数 
据 。 后 一 种 模式 是 对 前 者 的 扩展 ， 是 通过 添加 一 个 额外 的 预备 步骤 来 实现 的 。 用 户 选 择 一 个 
数据 项 、 将 其 置 于 编辑 模式 、 编 辑 内 容 ， 然 后 将 更 改 保存 到 存储 层 。 

本 章 并 未 详细 介绍 编辑 -提交 (Editrand-Posb 模 式 ， 因 为 它 只 是 选择 -编辑 -提交 模式 的 简易 
版 本 。 本 章 中 的 “编辑 数据 ”和 “保存 数据 ”两 节 会 对 选择 -编辑 -提交 模式 进行 介绍 ， 并 且 
提供 对 编辑 -提交 模式 的 描述 。 我 们 仍然 用 示例 进行 说 明 。 

4.1.1 一 个 经 典 的 选择 -编辑 -提交 场景 

将 通过 一 个 让 用 户 从 下 拉 列 表 选 择 客 户 的 示例 开始 对 选择 -编辑 -提交 模式 进行 曾 述 。 接 
着 ， 包 含 所 选 客 户 信息 的 记录 会 呈现 到 编辑 表单 ， 可 以 在 那里 输入 更 新 并 最 终 验 证 和 保存 
它们 。 

在 这 个 示例 中 ， 域 模型 包含 一 个 从 经 典 的 Northwind 数据 库 推导 而 来 的 实体 框架 模型 。 
图 4-1 显示 了 示例 应 用 程序 的 初始 用 户 界面 。 


Customers 


Alfreds Futterkiste 


图 4-1 该 示例 应 用 程序 的 初始 界面 ， 这 里 首先 需要 用 户 做 一 个 选择 
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注意 : 

本 章 中 讨论 的 示例 并 没有 在 项 目 中 使 用 任何 以 某 种 方式 链接 或 诅 入 的 数据 库 。 所 有 示例 最 
终 都 把 简单 的 查询 调用 指向 到 一 个 Web 服务 ， 这 可 以 在 我 的 个 人 网 站 http://www.expoware.org 
中 找到 。 有 关 这 些 示例 的 详细 信息 ， 可 以 在 BookSamples.Components 库 项 目的 northwind.cs 
文件 中 找到 。 


1. 提供 数据 和 处 理 所 选 项 


下 面 的 列表 显示 了 填充 下 拉 列 表 以 便 为 用 户 提 供 初 始 界面 的 控制 器 操作 。 注 意 我 是 根据 
职责 驱动 设计 (Responsibility Driven Design，RDD) 方 法 论 中 定义 的 协调 器 原型 来 设计 控制 器 
的 (我 还 将 在 第 7 草 “ 设 计 ASPNET MVC 控制 右 的 注意 事项 ”中 讨论 作为 协调 器 的 RDD 和 
MVC 控制 器 。 现 在 姑且 认为 ， 协 调 器 是 一 个 对 事件 进行 反应 和 将 任何 进一步 的 操作 委托 给 
外 部 组 件 的 这 样 一 种 组 件 )。 协 调 器 仅 限于 传递 输入 和 捕获 输出 。 在 ASPNET MVC 中 将 控制 
句 作 为 协调 器 来 实现 是 有 益 的 ， 因 为 它 可 以 把 接收 请 求 的 层 从 处 理 请 求 的 层 中 解 粳 出 来 。 为 
简单 起 见 ， 这 里 的 代码 并 不 使 用 依赖 性 注入 。 下 一 个 显而易见 的 步骤 是 通过 控制 反 转 
(Inversion of Control，IoC) 来 注入 协调 器 类 的 实例 一 一 HomeService。 


public class HomeController : Controller 


{ 
private readonly HomeService service = new HomeService(); 
public ActionResult Index() 
{ 
Var model = service.GetModelForIndex (); 
return View (model); 
} 
} 


Index 方法 会 获取 一 个 视图 模型 对 象 ， 它 包含 了 要 显示 的 客户 列表 。 


public class IndexViewModel : ViewModelBase 


{ 
public IndexViewModel () 
{ 
Customers = new List<SimpleCustomer> () ; 
} 
public IEnumerable<SimpleCustomer> Customers { get; set; } 
} 


下 面 是 协调 器 组 件 中 GetModelForIndex 方法 的 实现 : 


public class HomeService 


{ 
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public IndexViewModel GetModelForIndex () 
{ 


Var model = new IndexViewModel {Customers = 
NorthwindCustomers.GetAll ()}:; 


return model: 


} 
4-1 中 产生 接口 的 视图 如 下 所 示 : 


Gmodel Sep.ViewModels.Home.IndexVviewModel 


<Q1IV class="floating"> 
<p class="legend">Customers</p> 
Qusing (Html .BeginForm("edit"™", “home")) 


{ 
QHtml .DropDownList ("customerList", new SelectList (Model .Customers, 
"Id", "Company™)) 
<input type="submit"™" name="btnEdit"™ value="Edit"™ /> 
} 
</d1lv> 


用 户 从 列表 中 选择 客户 后 (通过 单 击 提交 按钮 )， 即 提交 了 一 个 HomeController 类 上 的 用 
于 Edit 操作 的 POST 请 求 。 


用 于 Edit 操作 的 请 求 会 把 应 用 程序 转 成 编辑 模式 ， 并 显示 一 个 用 于 所 选 客 户 的 编辑 器 。 
可 在 图 4-2 中 看 到 ， 也 应 该 预计 到 这 样 的 连续 视图 可 以 保留 下 拉 列 表 的 当前 状态 。 下 面 的 代 
码 显 示 了 Home 控制 器 上 用 于 Edit 方法 的 一 个 可 能 实现 : 

public ActionResult Edit([Bind (Prefix = "customerList")] String customerId) 

{ 


Var model = service.GetModelForEdit (customerId); 
return View (model); 


} 

第 3 章 “ 模 型 绑 定 架构 ”指出 ，Bind 特性 会 指示 默认 模型 绑 定 器 将 名 为 customerList 的 
提交 字段 值 分 配 到 指定 的 参数 。 这 种 情况 下 ，GetModelForEdit 方法 会 检索 指定 客户 的 信息 ， 
并 传递 给 视图 引擎 ， 以 便 可 以 配置 并 同 用 户 显 示 一 个 输入 表单 : 

public EditViewModel] GetModelForEdit (String 1d) 

{ 


var model = new EditViewModel 
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{ 
Title = "Edit customer™, 
Customer = NorthwindCustomers .Get (1d), 
Customers = NorthwindCustomers .GetAlLl () 
}; 


return model; 

} 

为 何 GetModelForEdit 方法 还 需要 检索 客户 列表 ? 

这 是 没有 视图 状态 的 直接 后 果 。 视 图 的 所 有 内 容 每 次 都 必须 重新 创建 和 重新 填充 。 这 是 
HTTP 协议 的 一 个 关键 部 分 ， 涉 及 固有 的 HITP 无 状态 特性 。 在 ASPNET Web Forms 中 ， 大 
部 分 的 再 填充 工作 都 是 由 框架 的 抽象 层 通 过 存储 在 视图 状态 中 的 信息 自动 完成 的 。 而 在 
ASPNET MVC 中 ， 这 些 都 需要 你 来 完成 。 

在 前 面 的 代码 片段 中 ， 设 置 了 另 一 个 到 服务 层 的 调用 ;一 个 更 重 要 的 应 用 程序 可 能 会 绥 
存 数据 ， 并 从 那里 重新 加 载 。 但 是 ， 绥 存 层 也 可 以 纳入 存储 库 本 刁 。 

下 面 是 视图 的 代码 : 


amodel Sep.ViewModels.Home.EditViewModel 


<diy Class="contaijiner™> 
<div class="floating"> 
<p class="legend">Customers</p> 
Qusing (Html .BeginForm("edit"™", “home")) 


{ 
QHtml .DropDownList ("customerList", 
new SelectList (Model.Customers, "1d", "Company"™, 
Model .Customer.1Id)) 
<input type="submit"™" name="btnEdit"™ value="Edit™ /> 
} 
</div> 


<div class="floating-—-spacer"> 
QHtm1l .Partial ("uc customerEditor", Model .Customer) 
</dlv> 
</dliv> 
视图 的 结构 与 图 4-1 所 示 的 差不多 相同 , 唯一 的 区 别 在 于 视图 右 侧 是 基于 表格 的 编辑 器 。 
该 编 恰 颖 (uc _customerEditor.cshtml) 古 授 过 Partial HTML 帮助 器 创建 的 。 如 果 仔 细 观 察 原生 
HTML 帮助 器 的 列表 ， 会 发 现 两 个 看 似 相似 的 帮助 器 : Partial 和 RenderPartial。 它 们 的 区 列 
是 什么 呢 ? 第 2 章 “ASPNET MVC 视图 ”中 有 提示 ，Partial 只 返回 字符 串 ， 而 RenderPartial 
会 执行 呈现 字符 串 的 操作 。 如 果 目 标 只 是 创建 视图 ， 那 么 它们 几乎 完全 相同 ， 但 仍然 需要 一 
种 略微 不 同 的 编程 语法 。 要 调用 RenderPartial， 你 需要 在 Razor 中 定义 如 下 标记 : 
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@{ Html .RenderPartial (view) } 


4-2 显示 了 实际 运行 中 的 编辑 器 。 


) 谷 http://localhost.3595/home/edit 
localhost " 


Customers 

Around the Hom 
ID AROUT 
Company Around the Hom 
Contact Thomas Hardy 
Address 120 Hanover Sq. 

London 

countr ”|[ 吕 必 必 汪 汪汪 全 


Save 


卫 100% 


图 4-2 ”用户 可 以 修改 选中 的 客户 
3. 保存 数据 


在 显示 输入 表单 之 后 ， 用 户 可 输入 他 认为 有 效 的 任何 数据 ， 然 后 按 下 按钮 将 表单 内 容 提 
交 到 服务 器 。 下面 是 提交 变更 的 一 个 典型 表单 标记 (该 标记 是 uc_customerEditor.cshtml 文件 的 


内 容 )。 


model BooksSamples.Components.Data.SsimpleCustomer 


<dlv Class="container™> 


Qusing (Html .BeginForm("update"™", "customer", new { customerId = Model.Id })) 


{ 


<table 1id=" tableCustomerEditAscx" rules="rows" frame="hsides"> 


<tr> 
<td width="100px"><b>ID</b></td> 
<td width="350px">@Model .Id</td> 
</tr> 
<Lr> 
<td><b>Company</b></td> 
<td><span>l@Model .Company</span></td> 
</tr> 
<tr> 
<td><b>Contact</p></td> 
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< 七 G>QHtml .D1SsSP1LayTextEor (C => c.Contact)</td> 
< /七 工 > 


<tr> 
<td><b>Country</b></td> 
<td>@Htm]l .TextBoxFor(c => Cc.Country, 
new Dictionary<String, Object>() { { "class"™, 
"textBox™” } 用) 


<br /> 
QHtml .ValidationMessage ("country") 
</td> 
</tr> 
</table> 
<br/> 
<input id="btnsave™" type="submit"™" Value="SaVe" /> 
} 
</dliv> 


通常 情况 下 ， 你 要 用 一 个 ValidationMessage 帮助 器 对 所 有 可 编辑 的 字段 (比如 文本 框 ) 进 
行 分 组 。 验 证 帮助 器 会 显示 由 于 字段 中 输入 无 效 值 而 产生 的 任何 结果 。 此 外 ， 你 要 确保 生成 
的 URL 包含 一 个 关键 值 ， 用 于 要 更 新 记录 的 唯一 标识 。 下 和 面 是 一 个 示例 : 


Html .BeginForm("update", "home", new { customerId = Model.CustomerID }) 
在 内 部 ，BeginForm 会 将 它 接收 的 数据 与 已 注册 URL 的 路 由 参数 相 匹 配 ， 试 图 创建 合适 
的 URL 以 提交 表单 。 前 面 的 代码 会 生成 下 面 的 URL: 


http://yourserver/customer/update?customerId=alfk1i 


正 是 由 于 有 了 默认 的 模型 绑 定 器 ， 所 有 Update 方法 才 可 以 作为 SimpleCustomer 类 的 成 
员 接收 输入 表单 的 字段 ， 


public ActionResult Update (SimpleCustomer customer) 


{ 
Var modelstate = ViewData.Modelstate 
Var model = service.TryUpdateCustomer (modelstate, customer),; 
return View("edit™", model); 

} 


该 方法 需要 做 两 件 事 : 更 新 数据 层 和 显示 编辑 视图 ， 这 样 用 户 束 可 以 持续 进行 更 改 。 除 
了 一 些 异 常 简单 的 场景 ， 更 新 操作 都 需要 进行 验证 。 如 果 对 正在 被 存储 的 数据 的 验证 失败 ， 
那么 检测 到 的 错误 必须 通过 用 户 界 面 报告 给 最 终 用 户 。 

ASPNET MVC 的 基础 架构 对 源 于 验证 的 错误 消息 的 显示 提供 了 内 置 文 持 。ModelState 
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字典 一 一 Controller 类 的 一 部 分 一 一 是 方法 添加 错误 通知 的 地 方 。ModelState 字典 中 的 错误 随 
后 会 通过 ValidationMessage 帮助 器 显示 出 来 ， 如 下 所 示 : 


public EditCustomerViewModel TryUpdateCustomer (ModelstateD1ictionary 
modelstate, Customer customer) 


{ 
if (Validate (modelState, customer)) 
Update (customer); 
return EditCustomer (CUstomeTr .CUstomerID) ; 
} 


private static Boolean Validate (ModelstateDictionary modelstate, Customer 


customer) 
{ 
var result = true; 
// Any sort of specific validation You need ... 
1if (!CountryIsValid (customer.Country))) 
{ 
// For each detected error, add a message and set a new display Value 
modelstate.AddModelError ("Country", “Invalid country."™); 
result = false; 
} 
return result; 
} 


private static void Update (Customer customer) 


{ 


NorthwindCustomers.Update (customer); 


} 

顾名思义 ，Modelstate 字典 就 是 与 视图 背后 的 模型 状态 有 关 的 所 有 消息 的 关键 字 / 值 存 售 
库 。 其 中 值 就 是 错误 消 轧 ; 关键 字 是 用 于 标识 条 目 ( 如 前 面 示 例 中 的 字符 串 “Country”) 的 唯 
一 名 称 。 模 型 状态 条 目的 关键 字 要 与 Html.ValidationMessage 帮助 器 的 字符 串 参 数 相 匹配 。 
图 4-3 显示 了 当 用 户 输入 无 效 值 时 系统 的 反应 。 

验证 过 程 中 ， 每 当 在 提交 的 数据 中 检测 出 一 个 错误 ， 就 会 在 ModelState 字典 中 添加 一 个 
新 条 目 ， 如 下 所 示 : 


modelstate.AddModelError ("Country", "Invalid Country-") :; 


提供 本 地 化 的 错误 消息 是 你 的 责任 。 
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lOE http:/ /localhost:3595/home/update/ALFK] 


Customers 


Alfreds Futterkiste WA 


ALFKI 

Alfreds Futterkiste 
Mana Anders 
Obere Str. 57 
Berlin 


Invalld country. 


图 4-3 处理 无 效 输入 


注意 ， 如 果 不 能 通过 各 种 值 提供 程序 (比如 表单 、 路 由 参数 或 查询 字符 串 ) 找 到 相应 的 匹 
配 ， 则 模型 绑 定 融会 将 参数 设置 为 nmull。 尤 其 ， 这 意味 着 字符 串 参 数 或 字符 串 成 员 可 以 被 设 
置 为 null。 在 尝试 使 用 通过 了 模型 绑 定 的 值 之 前 ， 你 应 该 随时 检查 是 否 有 null 值 。 下 面 的 代 
码 显 示 了 当 涉 及 字符 串 时 ， 处 理 这 种 情况 的 可 行 方法 : 
// In the examples for this chapter, validation 1s really coding in this way. 
In the end, 


// validation 1is a plain logical expresslon suggested by business. While this 
condit1ion 


// 1s not much realistic, it still makes perfectly sense in a demo. Anyway, 
note that in light 


// of this code any "valid™" country name you enter 1s denied except "USA". 
if (String.IsNulloOrEmpty (customer.Country) 
|| li!customer.Country.Equals ("USA")) 


} 
考虑 前 面 的 代码 ， 要 在 CountryIsValid 方法 中 放置 针对 null 值 的 检验 。 
4.1.2 ”应 用 提交 - 重 定向 -获取 (Post-Redirect-Get) 模 式 
以 前 输入 表单 的 方法 很 实用 , 但 并 不 完美 。 首先 ， 地 址 栏 中 的 URL 不 一 定 反映 页 面 显示 
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的 数据 。 其 次 ， 重 复 上 次 的 操作 (刷新 或 Fs 按键 ) 可 能 不 只 是 提示 用 户 如 图 4-4 所 示 的 烦人 的 
确认 消 晨 。 随 着 用 户 继 续 操 作 , 如 果 重 复 的 操作 没有 用 等 性 实现 ( 即 : 不 论 被 连续 调用 多 少 次 ， 
都 没有 产生 相同 的 结 末 )， 便 很 可 能 引 及 运行 时 异 贡 。 


To display the webpage again, the web browser needs to 
入 resend the information you've previously submitted., 


lf you were making a purchase, you should click Cancel to 
avoid a duplicate transaction. Otherwise, click Retry to display 
the webpage again. 


cane 
图 4-4 重新 提交 表单 时 浏览 器 显示 的 确认 消息 


然而 ，ASPNET 应 用 程序 的 这 些 方面 并 不 是 特别 针对 ASPNET MVC 的 。 它 们 也 存在 于 
ASPNET Web Forms 中 ， 但 这 并 非 避 人 免 使 用 更 好 实现 方法 的 理由 。 

浏览 器 地 址 栏 中 的 URL 与 显示 的 内 容 之 间 缺 乏 同 步 性 在 大 多 数 情况 下 不 算 什 么 问题 。 甚 
至 你 的 用 户 都 不 一 定 会 注意 到 。 事 实 上 ， 当 用 户 刷 新 当前 页 面 时 提示 用 户 的 确认 对 话 框 对 于 
ASPNET 开发 人 员 以 及 他 们 的 应 用 程序 用 户 来 说 并 不 陌生 (也 并 不 愉快 )。 我 们 看 看 提交 - 重 定 
问 - 获 取 (PRG) 模 式 如 何 帮 助 解决 这 两 方面 的 问题 。 


1. 保持 URL 与 内 容 同 步 


比如 , 在 前 面 的 示例 中 ， 当 用 户 选 择 用 户 第 一 条 记录 (ALFKD 之 后 , 地 址 栏 中 会 显示 如 下 


// Actlon EDIT on CUSTOMER controller 
http://yourserver/customer/edit 


如 果 用 户 重复 上 次 的 操作 (比如 ， 通 过 按 F5)， 会 得 到 如 图 4-4 所 示 的 对 话 框 ， 之 后 视图 
会 如 预期 一 样 更 新 .用 URL 来 反映 所 选 的 客户 以 及 无 副作用 地 使 页 面 刷新 , 这 样 不 是 很 好 吗 ? 

由 图 4-4 中 对 话 框 所 代表 的 副作用 有 一 个 著名 的 起 源 。 当 按 下 F5 键 时 , 浏览 器 只 是 让 有 目 
地 重复 进行 最 后 一 个 HTTP 请 求 。 并且, 客户 从 下 拉 列 表 中 所 做 的 选择 (参见 图 4-1) 是 Customer 
控制 器 上 Edit 操作 的 一 个 HTTP POST 请 求 。 

PRG 模式 建议 每 个 POST 请 求 在 经 过 处理 后 ， 以 重 定 问 到 一 个 通过 GET 访问 的 资源 而 
结束 。 这 样 做 能 够 使 URL 与 所 显示 的 客户 保持 恨 好 的 同步 ， 并且 用 户 不 会 再 看 到 图 4-4 中 那 
令 他 们 讨厌 的 对 话 框 。 
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2. 分 隔 POST 和 GET 操作 

将 PRG 应 用 到 ASPNET MVC 应 用 程序 的 第 一 步 是 将 POST 操作 与 GET 操作 清晰 地 分 
隔 开 来 。 下 面 是 如 何 重 与 Edit 操作 : 

[HLELPPost | 


[ActionName ("edit")] 
public ActionResult EditViaPost([Bind (Prefix = "customerList")] String 


customerId) 
{ 
// POST, now REDIRECT via GET to Edit 
return RedirectToAction("edit™, new {id = customerId}); 
} 
[HttpGet] 


[ActionName ("ed1it"})] 

public ActionResult EditViaGet (String 1d) 

1 

Var model = Sservice.GetModelForEdit (1d); 
return View("edit"™, model):; 

} 

每 一 次 用 户 提 交 Edit 方法 以 选择 一 个 指定 客户 时 ， 所 发 生 的 都 是 一 个 通过 GET 到 相同 
操作 的 重 定向 (HTTP 302)。 用 于 Edit 操作 的 GET 方法 会 接收 要 编辑 的 客户 ID ， 并 像 平常 一 
样 工 作 。 

不 错 的 效果 是 可 以 用 两 种 方式 改变 选择 : 在 地 址 栏 中 键入 URL( 作 为 命令 ) 或 仅仅 单 击 下 
拉 列 表 。 此 外 ， 当 用 户 界 面 更 新 了 ， 由 浏览 器 跟 踩 的 最 后 一 个 操作 是 Get， 那 么 就 可 以 按 自 
己 的 意 藉 多 次 重复 这 一 Get 操作 ， 而 不 会 招致 任何 无 聊 的 警告 或 烦人 的 异 第 。 


3. 仅 通过 POST 更 新 

回头 再 看 看 图 4-3， 它 显示 了 更 新 后 的 页 面 。 特 别 是 图 中 显示 了 一 个 失败 的 更 新 ， 但 与 
此 处 要 介绍 的 并 不 相关 。 相 反 ， 相 关 的 是 其 URL。 

http://yourserver/customer/update?customerId=ALFKI 


这 是 按 F5 键 时 会 重复 的 URL。 很 难 相信 任何 普通 用 户 会 尝试 手动 编辑 此 URL， 并 试图 
将 更 新 推送 给 另 一 个 客户 。 然 而 可 能 性 小 归 小 ， 但 绝对 是 有 可 能 的 。 

更 新 操作 的 URL 不 应 该 对 用 户 可 见 。 用 户 会 执行 更 新 , 但 操作 仍然 隐藏 在 同一 页 面 的 两 
次 显示 之 间 。 这 与 PRG 模式 中 的 情况 完全 一 样 。 下 面 是 如 何 重 写 Update 操作 的 代码 : 


[HELPEostI1 
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public ActionResult Update (SimpleCustomer customer) 


{ 
var modelstate = ViewData.ModelState; 
service.TryUpdateCustomer (modelstate, TempData, customer); 
return RedirectToAction("edit"™", new { 1d = CUstomer .Id }); 
} 


可 以 看 出 , 你 需要 的 只 是 HttpPost 支撑 。 用 户 会 从 一 个 通过 GET 操作 创建 的 页 面 执行 更 
新 ， 该 页 面 显 示 了 正在 被 编辑 的 客户 。 更 新 随即 上 友 生 ， 接 下 来 的 视图 是 通过 再 次 重 定 癌 到 相 
同 客户 的 Edit 操作 来 获得 的 。 这 一 过 程 十 分 简单 、 简 洁 和 高 效 。 


4. 跨 重 定向 的 临时 数据 保存 


还 有 最 后 一 个 问题 需要 考虑 。PRG 模式 使 整个 代码 看 起 来 更 整洁 ， 但 需要 两 次 请 求 以 便 
更 新 视图 。 这 可 能 造成 性 能 方面 的 问题 ， 但 也 说 不 定 一 我 认为 可 能 性 不 大 。 无 论 有 没有 ， 
都 主要 是 指 功能 上 的 问题 : 如果 更 新 失败 ， 你 如 何 将 反馈 传递 给 视图 ? 事实 上 , 在 GET 操作 
中 视图 会 继 重 定 同 之 后 进行 呈现 ， 它 是 一 个 截然 不 同 的 空白 请 求 。 

总 体 而 言 ， 最 好 的 选择 是 将 反馈 消息 保存 到 Session 对 象 。ASPNET MVC 提供 了 一 个 略 


现 的 。 下 面 沽 示 了 如 何在 更 新 之 前 修改 验证 代码 : 


private static Boolean Validate (ModelstateDictionary modelstate, 
TempDataDictionary tempData, 
simpleCustomer customer) 


{ 
Var result = true,; 
if (String.IsNullOorEmpty (customer.Country) 
11 icustomer.Country.Equals ("USA")) 
{ 
modelstate.AddModelError ("CountrY"，"InVal1d country."™); 
// Save model-state to TempData 
tempDatal"Modelstate"|] = modelstate; 
result = false; 
} 
return result; 
} 


首先 像 往常 一 样 将 反馈 消息 添加 到 ModelState 字典 。 然 后 , 将 对 ModelState 的 引用 保存 
到 TempData 字典 。TempData 字典 会 在 两 次 请 求 期 间 把 你 提供 的 所 有 数据 保存 在 会 话 状态 中 。 
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在 通过 存储 器 的 第 二 个 请 求 被 处 理 后 ， 容 需 将 清除 该 条 目 。 
对 于 其 他 任何 你 需要 传递 到 视图 对 象 的 信息 或 数据 都 要 做 相同 的 处 理 。 例 如 ， 图 4-5 摘 
述 了 在 更 新 操作 成 功 完成 以 后 通过 下 列 代码 添加 的 信息 : 


private Boolean Update (TempDataDictionary tempData, SimpleCustomer customer) 


{ 
// Perform physical update 
var result = repository.Update (customer); 
// Add a message for the user 
Var msg = result 
2 ™Successfully updated.™" 
: "Update failed. Check Your input datal!™; 
tempData[l"OutputMessage"|] = msqg; 
return result; 
} 


(9 ee http://localhost:3595/home/edit/ALFKI 


localhost 


Customers 


Alfreds Futterkiste A 


ALFK] 

Alfreds Futterliste 
Mana Anders 
Obere str 57 
Berlin 


Country [Bama 


Successfully updated. 


4-5 蝎 新 提交 后 的 消 乱 


你 可 能 仍然 会 想 在 重新 显示 相同 编辑 表单 之 前 就 所 及 生 的 事情 向 用 户 提 供 一 些 明 确 的 
反馈 ， 以 使 用 户 继续 正常 的 工作 。 如 果 更 新 操作 把 用 户 带 到 了 完全 不 同 的 页 面 ， 可 能 就 不 需 
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要 前 面 的 工作 了 了 。 
将 数据 保存 到 TempData 字典 只 完成 了 一 半 的 工作 。 还 需要 添加 从 会 话 状态 中 检索 字典 
的 代码 ， 并 将 其 与 当前 的 模型 状态 合并 。 这 个 逻辑 要 在 实际 呈现 视图 的 代码 中 实现 。 


[HttpGet] 
[ActionName ("ed1it"})] 
public ActionResult EditViaGet (String 1d) 

{ 
// Merge current Modelstate with any being recovered from TempData 
LoadstaterFrromTempData (); 


} 
private void LoadstateFromTempData () 
{ 
Var modelstate = TempDatal[l"Modelstate"] as ModelstateDictionary; 
1f (modelstate != null) 
Modelstate.Merge (modelstate).; 
} 


有 了 这 些 少 许 变 化 , 就 可 以 设置 读 写 简单 且 运 行 高 效 的 输入 表单 了 。 按照 PRG 模式 构建 
的 输入 表单 ， 其 唯一 缺陷 是 每 个 操作 都 需要 请 求 二 次 重 定 癌 。 此 外 ， 还 需 将 珊 有 呈现 视图 所 
需 数 据 的 视图 模型 封 流 起 来 ， 包 括 由 正在 进行 的 操作 所 计算 出 的 数据 以 及 与 页 面 有 关 的 任何 
其 他 数据 ， 如 沫 单 、 面 包 届 导航 和 列表 等 。 

不 过 ， 要 超越 这 一 实现 水 平 ， 你 需要 采用 Ajax 方式 。 


超越 经 暴 的 以 浏览 器 为 主导 的 内 容 表 单 提交 

经 典 的 表单 提交 大 部 分 发 生 在 整个 页 面 刷 新 的 情况 下 ， 有 时 候 发 生 在 两 次 HTTP 请 求 的 
情况 ， 就 像 PRG 模式 中 一 样 。 有 没有 无 需 整 页 刷新 就 可 实现 输入 表单 的 方式 呢 ? 

确实 有 几 种 方式 ， 但 它们 各 有 技巧 ， 因 此 请 以 个 人 喜好 为 准 。 一 般 情 况 下 ， 我 会 使 用 两 
种 可 能 的 方法 构建 自己 的 表单 : 经 由 PRG 模式 提交 的 普通 旧式 表单 、 和 使 用 Ajax 的 模 态 输 
入 表单 。 通 过 Ajax.BeginForm HTML 帮助 器 ，ASPNET MVC 的 确 对 Ajax 驱动 的 提交 有 一 


些 原生 文 持 。 为 外 , 可 通过 使 用 一 些 技术 来 手动 构建 模 态 和 输入 表单 , 如 用 于 用 尸 界 面 的 Twitter 
引导 程序 (和 模 态 弹出 式 基础 染 构 )、 用 于 客户 端 检 验 的 jQuery 验证 以 及 用 于 提交 的 
XmlHttpRequest( XHR).。 

http://software2cents.wordpress.com/2013/06/07/modal-input-forms-with-bootstrap/ 古 我 的 一 
个 博客 帖子 ， 在 其 中 的 ASPNET MVC 应 用 程序 上 下 文中 ， 可 以 找到 一 个 不 错 的 模 态 输入 
表单 的 启动 示例 。 该 帖子 说 明了 如 何 使 用 集成 于 ASPNETMVC 5 的 CSS 库 中 的 Twitter 引导 
程序 。 
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4.2 输入 表单 的 目 动 化 编写 


输入 表单 在 视图 的 组 织 结构 中 扮演 了 十 分 重要 的 角色 。 输 入 表单 通常 包含 图 片 、 请 求 字 
段 的 具体 位 置 ， 以 及 丰富 的 客户 端 内 容 。 在 所 有 这 些 情况 下 ， 你 很 可 能 需要 从 涉 开始 编写 输 
入 表单 的 模板 。 

然而 ， 一 般 来 说 ， 有 许多 其 他 情况 可 以 自动 化 构建 输入 表单 。 比 如 ， 编 写 一 个 网 站 的 后 
台 就 属于 这 种 情况 。 后 台 系 统 通常 包括 大 量 用 于 编辑 记录 的 表单 ; 但 是 ， 作 为 开发 人 员 ， 你 
不 用 关心 图 表 的 问题 。 你 需要 关注 的 是 效用 ， 而 不 是 样式 。 简 而 言 之 ,后 台 系 统 是 不 用 顾虑 
地 使 用 表单 输入 模板 的 自动 生成 器 的 完美 情形 。 


4.2.1 预定 义 的 显示 和 编辑 器 模板 


第 2 章 展 示 了 模板 化 的 HTML 帮助 器 ,如 DisplayXxx 和 EditorXxx 等 。 这 些 帮 助 器 可 以 
使 用 一 个 对 象 (甚至 传递 到 视图 的 整个 模型 ) 并 构建 一 个 只 读 或 可 编辑 的 表单 。 可 以 使 用 下 面 
的 表达 式 来 指定 要 显示 或 编辑 的 对 和 象 : 


Html .DisplayFor (model => model .Customer) 
Html .EditorFor (model => model .Customer) 


model 参数 往往 是 要 传递 给 视图 的 模型 。 可 以 使 用 自己 的 lambda 表达 式 来 选择 整个 模型 
的 一 个 子 集 。 要 选择 整个 模型 (比如 说 ， 为 了 进行 编辑 )， 可 以 选择 下 面 任意 一 个 功能 相当 的 
表达 式 : 

Html .EditorFor (model => model) 

Html .EditorForModel () 


置 于 模型 类 的 公共 成 员 上 的 特性 提供 了 对 如 何 显示 单个 值 的 指引 。 我 们 看 看 这 是 如 何 用 
于 实践 的 。 


1. 用 于 显示 的 批注 数据 成 员 


在 ASPNET MVC 中 ， 模 板 化 帮助 器 使 用 与 类 成 员 相 关联 的 元 数据 来 决定 如 何 显 示 或 编 
辑 你 的 数据 。 元 数据 通过 元 数据 提供 程序 对 象 读 取 ; 默认 的 元 数据 提供 程序 会 从 数据 批注 特 
性 中 获取 信息 。 表 4-1 列 出 了 最 常用 的 特性 。 
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表 4-1 一 些 影响 数据 呈现 的 批注 


DataType 表示 你 将 通过 该 成 员 编 辑 的 推测 数据 类 型 。 它 会 接收 来 自 DataType 枚 举 的 值 。 文 持 的 
数据 类 型 包括 Decimal、 Date、DateTime、 EmailAddress、Password、Url、PhoneNumber 
以 及 MultilineText 


DisplayFormat 用 此 表示 通过 哪 种 格式 来 显示 (和 /或 编辑 ) 伸 。 例 如 ， 可 使 用 此 批注 来 表明 一 个 null 或 
衬 介 的 但 代表 示 。 此 例 中 ， 你 要 使 用 NullDisplayText 属性 
DisplayName 表示 用 于 表示 值 的 标签 的 文本 


HiddenInput 表示 一 个 隐藏 输入 字段 是 否 应 该 显示 以 蔡 代 一 个 可 见 输 入 字段 
UIHint 表示 在 显 式 或 编辑 值 时 使 用 的 目 定 义 HIML 模板 的 名 称 


批 广 存 在 于 各 种 闫 型 的 名 称 空 间 中 , 包括 System.ComponentModel 和 System.ComponentModel 
DataAnnotations。 如 有 果 探 完 这 些 ( 以 及 其 他 ) 名 称 空间 ， 你 甚至 可 以 找到 更 多 特性 ,但 其 中 一 些 
也 许 不 能 用 于 ASPNET MVC， 至 少 不 会 以 你 认为 的 方式 。 

数据 批注 是 特性 ， 而 特性 通常 不 包含 代码 。 它 们 仪 仅 表 示 其 他 模块 需要 使 用 的 元 信息 。 
通过 使 用 数据 批注 ， 你 的 模型 对 象 束 被 元 数据 修饰 了 。 这 并 不 能 预计 产生 任何 的 可 见 影 响 : 
一 切 都 取决 于 其 他 组 件 如 何 使 用 元 数据 。 

在 ASPNET MVC 中 ， 默 认 的 显示 和 编辑 帮助 器 只 使 用 几 个 可 能 的 批注 。 然 而 ， 元 数据 
信息 就 在 那里 ， 并 且 如 果 重 写 默认 的 模板 ， 就 可 以 在 闲暇 时 使 用 更 多 可 用 的 元 信息 了 。 
ReadOnly 特性 就 是 一 个 批注 的 好 例子 ， 它 第 第 被 默认 模板 忽略 ,但 ASPNET MVC 能 够 解析 
它 并 将 其 公开 给 帮助 器 。 


注意 : 
数据 批注 包括 描述 性 特性 和 验证 特性 ， 描 述 性 特性 指示 侦 听 器 如 何 显示 或 编辑 数据 ， 验 
证 特性 指示 侦 听 器 如 何 验证 模型 类 的 内 容 。 稍 后 将 介绍 验证 特性 。 


下 面 的 代码 显示 了 一 个 用 批注 修饰 的 视图 模型 类 : 


public class CustomerViewModel : ViewModelBase 

{ 
[DisplayName ("Company ID") ] 
[Readonly (true)] // This will be blissfully ignored by default templates! 
public Int32 Id { get; set; } 


[DisplayName ("Is a Company (or individual)?")] 
public Boolean IsCompany { get; set; } 
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[DisplayFormat (NullDisplayText = "(empty)")] 
public String Name { get; set; } 


[DataType (DataType .MultilineText)] 
public String Notes { get; set; } 


[DataType (DataType .Url)] 
public String Website { get; set; } 


[DisplayName ("Does this customer pay regularly?")] 
public Boolean? IsReliable { get; set; } 
} 
注意 如 果 没 有 使 用 DisplayForModel 或 EditorForModel 自动 生成 输入 表单 ， 就 不 需要 数 
据 批注 。 与 任何 其 他 元 数据 一 样 ， 批 注 对 所 有 的 非 专门 设计 为 使 用 它们 的 代码 也 是 透明 的 。 
4-6 显示 了 EditorForModel 创建 的 用 于 前 面 模型 对 象 的 输入 表单 。 


< pe http:/ /localhost:851 /custormer/edit 


全 Sample custormer 


Company or individual 
Ea 


Name 


Website 


图 4-6 一 个 目 动 生成 的 输入 表单 


元 信息 会 指示 编辑 /显示 帮助 器 如 何 编辑 和 显示 值 。 这 会 导致 专 有 HTML 模板 的 使 用 ， 
如 用 于 多 行 类 型 的 TextArea 元 系 , 以 及 用 于 Boolean 值 的 复 选 框 。 对 于 可 为 null 的 Boolean 值 ， 
帮助 堪 还 会 自动 显示 一 个 三 态 的 下 拉 列 表 。 并 非 所 有 数据 类 型 都 要 在 编辑 模式 和 显示 模式 中 
显示 。 比 如 ，EmailAddress 和 Url 数据 类 型 仪 仪 在 显示 模式 中 表现 。 

确切 地 说 ， 由 于 样式 表 的 应 用 ， 图 中 显示 的 表单 还 要 经 历 一 组 微小 的 图 形变 更 。 编 辑 / 


119 


第 1 部 分 ASPNET MVC 基础 


显示 帮助 右 会 从 带 有 惯用 名 称 的 如 下 所 示 的 几 个 级 联 样 式 表 (CSS) 类 中 目 动 读 取 样式 信息 : 


.display-label, .editor-label I 
margin: lem 0 0 0; 
font—-weight: bold; 
} 
.display-field, .editor-field { 
margin: 0.5em 0 0 0; 
} 
-Lext—box f 
width: 30em; 
background: yellow; 
} 
.text—box.mult1i—-line 1{ 
height: 6.5em; 
} 
.tri—state I 
width: 6em; 
} 
尤其 是 ， 名 为 display-label 和 editor-label 的 类 指 的 是 围绕 轴 
式 和 内藤 到 视图 中 ， 也 可 以 从 全 局 共享 的 CSS 文件 中 继承 它们 。 


2. 用 于 数据 类 型 的 默认 模板 


显示 /编辑 帮助 器 是 通过 映射 每 个 成 员 的 数据 类 型 以 呈现 给 预定 义 的 显示 或 编辑 模板 来 
发 生 作 用 的 。 之 后 ， 对 于 每 个 模板 名 称 ， 系 统 会 要 求 视 图 引擎 返回 一 个 适当 的 部 分 视图 。 预 
定义 的 显示 模板 因为 这 些 数据 类 型 而 存在 : Boolean、Decimal、EmailAddress、HiddenInput、 
Html、Object、String、Text 和 Url。 数 据 类 型 是 通过 DataType 批注 或 值 的 实际 类 型 来 解析 的 。 
如 果 找 不 到 匹配 项 ， 则 使 用 默认 模板 ， 它 包含 用 于 显示 的 普通 文本 和 用 来 编辑 的 文本 框 。 让 
我 们 看 看 模板 是 什么 样子 。 下 面 的 清单 展示 了 一 个 用 于 显示 Url 数据 类 型 的 Razor 模板 的 实 
现 示例 : 


i 入 值 的 标签 。 可 以 将 这 些 样 


Qinherits System.Web.Mvc.WebViewPage<Sstring> 
<a href="@Model™> 
QViewData.TemplateInfo.FormattedModelValue 

</a> 

Url 数据 类 型 通过 一 个 超 链 接 来 呈现 ， 其 中 的 Model 对 象 会 引用 要 显示 的 数据 一 一 很 有 
可 能 是 一 个 表示 网 站 的 字符 串 。 你 会 发 现 ， 该 实际 值 是 用 来 设置 URL 而 不 是 超 链 接 的 文本 。 
TemplateInfo 对 象 上 的 FormattedModelValue 属性 可 以 是 最 初 的 原始 模型 值 ， 也 可 以 是 一 个 正 
确 格 式 化 的 字符 串 ， 如 果 通 过 批注 指定 了 格式 字符 串 的 话 。 
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注意 : 
TemplateInfo 属性 在 ViewData 对 和 象 上 定义 ， 但 通 第 为 null， 除 非 你 正 处 于 一 个 模板 中 。 
Url 模板 相当 简单 。 让 我 们 思考 一 个 更 有 趣 的 Boolean 值 的 模板 吧 : 
Gmodel bool? 


@if (Model == null) 


{ 
<text>Not Set</text> 
} 
else 
{ 
1f (Model .Value) 
{ 
<text>True</text> 
} 
else 
{ 
<text>False</text> 
} 
} 


由 于 该 模板 适用 于 Boolean 值 和 Nullable<Boolean> 值 ， 因 此 该 示例 包含 了 逻辑 和 标记 的 
组 合 。 
编辑 模板 与 显示 模板 并 没有 太 多 不 同 ， 人 至 少 在 结构 上 是 差不多 的 ; 但 是 ， 编 辑 模板 的 代 
码 会 更 复杂 一 些 。ASPNET MVC 提供 了 几 个 预定 义 的 编辑 器 用 于 Boolean、Decimal、 
HiddenInput、Object、String、Password 和 MultilineText。 下 向 是 一 个 输入 密码 的 编辑 器 示例 : 
@Htm] .Password("™", 
ViewData.TemplateInfo.FormattedModelValue., 
new { Qclass = "text-box single-line password™ }) 
可 以 看 到 ， 有 关 样 式 的 约定 源 于 默认 的 模板 实现 。 通 过 更 改 指 定数 据 类 型 的 默认 模板 ， 
就 可 以 根据 不 同 的 规则 选择 样式 了 。 
Object.cshtml 是 用 于 递归 循环 处 理 某 类 型 公共 成 员 的 模板 。 它 通过 使 用 专用 于 类 型 的 纺 
辑 器 来 构建 整个 表单 。Objectcshtml 的 默认 实现 会 垂直 堆 嫩 标 答 和 编辑 器 。 虽 然 它 对 于 快速 
建 模 较 有 价值 ， 但 你 通常 不 会 真正 考虑 将 它 用 于 实际 应 用 程序 。 我 们 继续 探 宛 如 何 自 定义 编 
辑 大 模板 吧 。 
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3. 用 于 数据 类 型 的 自 定 义 模板 


显示 /编辑 帮助 器 在 很 大 程度 上 可 以 自 定 义 。 任 何 自 定义 的 模板 都 包含 一 个 位 于 
Views\[controller]\DisplayTemplates 文件 严 用 于 显示 帮助 器 的 目 定 义 视 图 ， 和 一 个 位 于 
Views\[controllerj\EditorTemplates 文件 夹 用 于 编辑 帮助 器 的 自 定 义 视图 ,如 果 希 望 模 板 为 所有 
的 控制 器 共享 ， 就 将 它们 放 在 Views\Shared 中 。 如 果 视 图 的 名 称 与 数据 类 型 相 匹 配 ， 则 该 视 
图 会 变 成 这 个 数据 类 型 的 新 默认 模板 。 如 果 不 能 匹配 ， 则 访 视 图 不 会 使 用 ， 除 非 通过 UIHint 


批注 显 式 调用 ， 如 下 所 示 : 


public CustomerViewModel 


{ 


[UIHinNt ("CustomerViewModel Ur1")] 
public String Ur] {get; set;} 


} 


现在 Url 属性 通过 使 用 CustomerViewModel Url 模板 进行 显示 和 编辑 。 而 数据 类 型 是 Url 


的 属性 会 继续 由 默认 的 模板 服 务 。 


我 们 看 看 对 于 那些 甚至 没有 预定 义 模板 的 类 型 一 一 DateTime 类 型 ， 如 何 创建 一 个 自 定 义 


呵 


的 显示 和 编 


竹器 模板 。 下 面 是 一 个 Razor 显示 模板 的 内 容 : 


dmodel DateTime 
aaMode1lL .ToSstrlng("ddd，dq MMM yyyy") 


在 该 示例 中 ， 你 用 一 个 固定 的 格式 (但 由 你 控制 ) 显 示 日 期 ， 包 括 星期 几 、 几 月 份 和 哪 一 


年 。 下 面 是 一 个 用 于 日 期 的 编辑 器 模板 示例 : 


QQmodel DateTime 


<dliv> 

<table> 

<tr> 
<td>@QHtml. 
<td>@Html 

</tr> 

<Ttr> 
<td>@Html 
<td>Q@Html 

</tr> 

<tIr> 
<td>@Html 
<td>@Html 

</tr> 

</table> 


Label ("Day™")</td> 


.TextBox{("Day™", Model .Day)</td> 


.Label ("Month"}</td> 
.TextBox ("Month", Model.Month)</td> 


.Label ("Year™.} ></td> 
.TextBox("Year", Model.Year)</td> 
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</Ad17> 


可 通过 使 用 任何 你 喜欢 的 类 名 在 模板 中 设计 元 紊 样式; 只 要 那些 类 是 在 应 用 程序 中 的 茶 
些 样式 表 中 定义 的 ， 它 们 就 会 被 自动 使 用 。 注 意 你 在 模板 中 设置 的 ID 会 自动 在 发 出 标记 中 
加 上 成 员 名 称 的 前 级 。 例如， 如 果 把 上 面 的 日 期 模板 应 用 到 一 个 名 为 BirthDate 的 属性 ， 所 友 
出 的 实际 DD 就 会 是 BirthDate Day、BirthDate Month 和 BirthDate Year。 


注意 : 

这 可 能 是 一 个 不 太 会 发 生 的 场景 ， 但 如 果 刚 好 在 同一 页 面 有 两 个 用 于 相同 模型 的 编辑 
器 ， 那 么 这 种 情况 就 会 有 ID 冲突 了 ， 如 有 果 不 进 行 处 理 ， 模 型 帮助 器 就 可 能 无 法 解决 这 个 问 
题 。 如 果 处 于 这 种 情况 ， 可 以 考虑 我 们 在 第 3 章 中 讨论 的 技巧 ， 将 自 定义 类 型 的 集合 绑 定 到 
一 个 控制 器 方法 。 


如 何 命名 这 些 模板 ? 如 果 指 定 了 UIHint 特性 , 则 由 它 的 值 确定 模板 名 称 。 如 果 没 有 指定 ， 
那么 DataType 特性 会 优先 于 实际 的 成 员 类 型 名 称 。 对 于 以 下 类 定义 ,预期 的 模板 名 称 是 日 期 。 
如 果 没 有 视图 引 车 可 以 提供 这 样 的 视图 ， 融 会 使 用 默认 模板 。 图 4-7 显示 了 前 和 面 定义 的 基于 
表格 的 日 期 编辑 器 。 


l 痘 http:/ /localhost8315/ customer/edit 
sto 


FP Sample customer 
Company or individual 
| 


Foundation 
Day |12 | 
Month 


Year |2005 


Website 


图 4-7 用 于 编辑 日 期 的 目 定义 模板 


如 条 用 ReadOnly 特性 修饰 视图 模型 的 成 员 ， 你 大 概 会 预计 它 不 能 在 编辑 器 中 编辑 。 你 
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会 预计 显示 模板 是 在 编辑 器 中 使 用 以 用 于 模型 的 。 但 你 会 惊讶 地 友 现 情况 并 非 如 此 。 
ReadOnly 特性 会 被 元 数据 提供 程序 正确 识别 ， 相 关 信 息 存储 在 模型 可 用 的 元 数据 中 。 不 过 出 

可 能 这 听 起 来 有 些 奇怪 ， 你 有 数据 批注 来 指示 茶 个 指定 成 员 是 只 读 的 ， 但 这 并 不 会 被 默 
认 模 板 反 映 出 来 。 有 几 个 办 法 可 以 解决 此 问题 。 首 要 的 是 ， 可 使 用 UIHint 批注 指定 一 个 名 为 
readonly.cshtml 的 只 读 模 板 ， 如 下 所 示 : 


<span>l@Model</span> 


你 需要 将 readonly.cshtml 模板 放 在 编辑 器 文件 夹 中 。 

这 种 解决 方法 虽然 有 效 ， 但 它 绕 过 了 ReadOnly 特性 的 使 用 。 这 倒 不 是 什么 大 问题 ， 但 你 
很 可 能 想 知 道 是 否 有 一 种 解决 方法 可 以 强制 元 数据 提供 程序 以 不 同方 式 处 理 ReadOnly 特性 。 
你 需要 一 个 不 同 的 元 数据 提供 程序 ， 比 如 下 面 这 个 : 


public class ExtendedAnnotationsMetadataProvider : 
DataAnnotationsModelMetadataProvider 
{ 
protected override ModelMetadata CreateMetadata (IEnumerable<nAttribute> 
attributes, 
Type containerType, 
FUuNC<Object> modelAccessor., 
Type modelType, 
String propertyName) 


Var metadata = base.CreateMetadatal 
attributes, 
containerType, 
modelAccessor, 
modelType, 
propertyName); 


1f (metadata.IsReadonly) 
metadata.TemplateHint = "readonly"; // Template name 1s arbitrary 
return metadata; 


} 


你 要 创建 一 个 新 的 类 ， 它 继承 DataAnnotationsModelMetadataProvider 类 ， 并 重 载 
CreateMetadata 方 法 。 重 载 很 简单 一 先 调用 基本 方法 , 然后 检查 IsReadOnly 属 性 返回 的 内 容 。 
如 采访 成 员 声 明了 是 只 读 的 ,那么 可 以 用 编程 方式 将 TemplateHint 属 性 设置 到 你 的 目 定 义 只 读 
模板 (之 后 确保 该 模板 在 Views 文 件 夹 中 可 用 就 是 你 的 责任 了 )。 
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你 必须 加 系统 注册 一 个 自 定义 的 元 数据 提供 程序 。 可 以 使 用 两 种 方式 。 可 以 把 新 提供 程 
序 的 一 个 实例 存储 在 ModelMetadataProviders 类 的 Current 属 性 中 ， 如 下 所 示 ( 这 需要 在 
globalasax 文 件 的 Application Start 中 完成 )。 


ModelMetadataProviders.Current = new ExtendedAnnotationsMetadataProvider () ， 


在 ASPNET MVC 中 ， 你 有 男 一 个 同样 有 效 的 选择 : 使 用 依赖 解析 器 。 我 会 在 第 7 草 中 
讨论 依赖 解析 器 的 话题 。 现 在 ， 只 需要 说 明 ASPNET MVC 早期 版 本 的 所 有 可 插 拔 式 内 部 组 
件 以 及 很 多 新 的 组 件 ， 都 在 ASPNET MVC 中 ， 可 以 通过 使 用 类 似 服 务 定位 器 的 集中 式 服务 
(依赖 解析 器 ) 由 系统 发 现 。 服 务 定位 器 是 一 个 通用 组 件 ， 它 获取 一 种 类 型 (比如 一 个 接口 )， 并 
返回 男 一 种 类 型 (比如 实现 该 接口 的 一 个 具体 类 型 )。 

在 ASPNET MVC 中 ，ModelMetadataProvider 类 型 可 通过 依赖 解析 器 发 现 。 所 以 ， 你 要 
做 的 就 是 用 量 身 定做 的 依赖 项 解析 需 注 册 你 的 目 定 义 提 供 程 序 。 依 赖 解 析 器 是 知道 如 何 获 得 
请 求 类 型 对 象 的 一 种 类 型 。 下 面 的 代码 显示 了 一 个 为 此 方案 量 映 定做 的 简单 依赖 解析 器 : 


public class SampleDependencyResolver : IDependencyResolver 


| 
public object GetService (Type serviceType) 
{ 
try 
{ 
return serviceType == typeof (ModelMetadataProvider) 
? new ExtendedAnnotationsMetadataProvider() 
: Activator.CreateInstance (serviceType); 
} 
catch 
{ 
return null; 
} 
} 
public IEnumerable<object> GetServices (Type serviceType) 
{ 
return Enumerable.Empty<Object> (); 
} 
} 


你 要 像 这 样 在 global.asax 中 注册 解析 器 : 
DependencyResolver.SetResolver (new SampleDependencyResolver ()); 


请 注意 ASPNET MVC 会 试图 找到 一 个 有 效 的 ModelMetadataProvider 实现 ,首先 通过 探 
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寻 已 注册 的 解析 妖 ， 然 后 探寻 ModelMetadataProviders.Current 属性 。ModelMetadataProvider 
类 型 的 双重 注册 是 不 允许 的 ， 如 果 出 现 这 种 情况 ， 将 会 引发 异常 。 


注意 : 
支持 编辑 器 中 只 读 属 性 的 另 一 种 方法 是 修改 所 使 用 的 默认 模板 。 很 快 会 讨论 这 方面 的 


4.2.2 ”用 于 模型 数据 类 型 的 自 定 义 模板 


到 目前 为 止 ， 我 们 已 经 公开 了 作用 于 值 的 简单 类 型 的 有 关 显 示 和 编辑 器 模板 的 大 量 细 
节 。 然 而 ， 像 EditorForModel 和 DisplayForModel 这 些 帮 助 器 的 内 部 结构 却 提 供 了 一 些 通过 
模型 类 型 的 公共 接口 来 反映 和 构建 层级 视图 的 固有 能 力 。 这 种 行为 是 便 编 码 的 ， 但 它 过 于 人 简 
单 ， 在 实际 环境 中 不 太 有 用 。 在 这 一 节 中 ， 我 将 向 你 展示 如 何 重 写 显 示 和 编辑 器 模板 ， 使 泛 
型 看 起 来 更 像 表 格 。 换 句 话 说， 不 是 得 到 一 个 标签 和 值 <div> 的 垂直 扒 和 倒 面板， 而 是 一 个 两 列 
的 表格 ， 标 釜 在 左边 ， 值 在 右边 。 重 写 的 模板 叫做 对 象 。 


1. 表格 式 模 板 


编写 一 个 基于 表格 的 布局 是 一 个 相对 简单 的 任务 ， 它 包括 模型 对 象 属性 的 循环 壳 历 。 下 
耐 是 Razor 代 公 : 


Qinherits System.Web.Mvc.WebViewPage 


@if (Model == null) 
<span>@ViewData.ModelMetadata.NullDisplayText</span> 

else 

{ 


<table cellpadding="0"™ cellspacing="0"™ class="display-table"> 
Qforeach (var prop in ViewData 

.ModelMetadata 

.Properties 

.Where (pm => pm.ShowForDisplay 

&& IViewData.TemplateInfo.Visited (pm))) 


<tr> 
<td> 
<div class="display-label"> 
Qprop.GetD1isplayName () 
</d1lv> 
</td> 
<td> 
<div class="display-field"™"> 
<span>@Html .Display (prop.PropertyName) </span> 
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</d1liv> 
</td> 
</tr> 
} 
</table> 


} 

如 果 模 型 为 null， 你 只 需要 为 模型 类 发 出 默认 的 null 文本 。 如 果 不 为 null， 则 要 循环 处 
理 所 有 属性 ， 并 为 所 有 没有 被 预先 访问 且 设 置 用 于 显示 的 属性 创建 一 个 表格 行 。 对 于 每 一 个 
属性 ， 你 再 以 递归 方式 调用 显示 HIML 帮助 器 。 可 以 任意 设计 每 一 小 块 标记 的 样式 。 在 此 示 
例 中 ， 我 会 介绍 一 个 新 的 表格 级 别 的 样式 ， 称 为 显示 表格 。 | 4.8 显示 其 结 末 。 


[< 二 httpi/ /localhostB315c 
Cr 


Ls Company Yes 
Name e-tennis.NET 
Notes My company 


Faundatien sat 12 Mar 2005 


Reliable? Not Set 


图 4-8 ”表格 去 默认 显示 模板 


编辑 器 模板 更 复 杀 一 些 ， 因 为 它 要 负责 验证 错误 和 必需 的 字段 。 该 模板 有 额外 的 一 列 用 
ye 是 每 个 编辑 器 的 项 部 都 有 -个 验证 消息 的 标 
人 0 下 和 面 是 源 代码 : 


Qinherits System.Web.Mvc.WebViewPage 
@if (Model == null) 
<span>@viewData.ModelMetadata.NullDisplayText</span> 
else 1 
<table cellpadding="0"™ cellspacing="0™ class="editor-table"> 
Qforeach (var prop in ViewData 
-ModelMetadata 
.Properties 
.Where (pm => pm.ShowForDisplay 
&& IViewData.TemplateInfo.Visited (pm) ) ) 


<tr> 
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站 加 
<div class="editor-label"> 
aprop .GetD1sp1LayName () 
</div> 
</td> 
<td width="10px"> @ (prop.IsRequired 2 "+*" : "") </td> 
<td> 
<dly class="editor-field"> 
@1if (prop.IsReadonly) 


{ 
<Span>QHtml .Display (prop.PropertyName) </span> 
} 
else 
{ 
<span>@Html .Editor (prop.PropertyName) </span> 
<span>@Html .ValidationMessadge (prop.PropertyName, 
"*") </span> 
} 
</div> 
</td> 
</tr> 
} 
</table> 


} 
4-9 显示 了 实际 运行 中 的 编辑 器 。 


Xe 登 hitp:// localhost8313,/customer/edit 


Omer 


到 4-9 表格 式 默认 编辑 器 模板 
2. 处 理由 套 模型 
最 后 要 说 明 的 一 点 是 ， 当 模型 类 型 具有 藤 套 模型 时 所 预期 的 模板 行为 。 到 目前 为 止 以 递 
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归 方式 显示 的 代码 找 出 了 嵌 套 模型 的 属性 ， 并 将 它们 像 通 常 那样 呈现 。 设 想 一 下 你 有 下 面 的 
模型 。 


Public class CustomerViewModel 
{ 


public ContactInfo Contact {get; set;} 


public class ContactInfo 

{ 
public String FullName {get; set;]} 
public String PhoneNumber {get; set;} 
public String Email {get; set;} 

} 


图 4-10 显示 了 其 结果 


CE 


Reliable? Not Set 


FullName D.E. 


Contact phoneNumber 000 


Email d®@d.com 


Title Sample customer 


图 4-10 要 套 模型 


作为 开发 人 员 ， 可 以 在 菜 种 程度 上 控制 这 一 行为 。 通 过 在 模板 的 代码 中 添加 一 个 额外 的 
站 分 文 ， 可 将 租 套 级 别 限 制 在 你 希望 的 级 别 ( 此 示例 中 是 1)。 


lf (Model == null) 
<span>@VviewData.ModelMetadata.NullDisplayText</span> 
else 
if (ViewData.TemplateInfo.TemplateDepth > 1) 
{ 
<span>@viewData.ModelMetadata.SimpleDisplayText</span> 
} 


else 
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Ea 
TemplateDepth 属性 会 衡量 允许 的 藤 套 级 别 。 随 着 该 代码 的 启用 ， 如 果 钥 套 级 别 高 于 1， 
则 要 采用 子 模型 的 简化 表示 。 可 以 通过 重 写 子 模型 类 型 的 ToString 来 控制 这 种 表示 。 


Public class ContactIinfo 


{ 


public override string ToSstring () 
{ 
return "[ContactInfo description herel]™; 
} 
} 


或 者 ， 可 以 选择 一 列 并 将 之 用 于 呈现 。 通 过 使 用 子 模型 类 型 上 的 DisplayColumn 特性 来 
选择 该 列 。 

[DisplayColumn ("FullName")] 

public class ContactInfo 


{ 


} 
DisplayColumn 特性 优先 级 高 于 ToString 的 重 载 。 


注意 : 

如 你 所 见 ，HiddenInput 特性 可 以 隐藏 一 个 来 自视 图 的 指定 成 员 ， 同时 通过 一 个 隐藏 字段 
上 传 其 内 容 。 如 果 布 望 帮 助 器 忽略 指定 的 成 员 ， 则 可 以 使 用 ScaffoldColumn 特性 并 给 它 传 递 
一 个 false 值 。 


4.3 输入 验证 


编程 的 书籍 往往 充斥 着 诸如 “输入 是 不 可 信 的 ”语句 ， 当 然 ， 专 门 介 绍 输入 表单 的 一 章 
不 可 能 漏 掉 有 关 输 入 验证 的 部 分 。 如 果 想 要 讨论 它 的 必要 性 ， 就 应 该 专注 于 服务 器 端 验证 ， 
想 想 可 用 的 最 好 技术 是 什么 ， 以 最 有 效 的 方式 帮助 应 用 程序 和 业务 域 的 验证 。 

然而 ， 话 虽 如 此 ， 但 确实 没有 理由 跳 过 客户 端 验证 步骤 ， 它 恰恰 能 够 阻止 明显 无 效 的 数 
据 进入 服务 器 且 耗 费 宝贵 的 CPU 周期 。 因 此 ， 你 应 该 对 客户 端 和 服务 器 端的 验证 都 有 兴趣 。 
但 是 ， 即 使 在 一 般 复 杂 的 Web 应 用 程序 中 ， 验 证 也 至 少 会 应 用 于 两 个 层面 : 验证 从 浏览 器 接 
收 的 输入 ， 以 及 验证 系统 后 端 要 存储 的 数据 。 

这 两 个 层面 有 时 候 可 能 是 同一 个 ， 但 这 并 不 是 现实 中 以 及 一 些 很 酷 的 技术 书籍 和 指南 之 
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外 常 有 的 情况 。 除 非 域 模型 本 质 上 一 对 一 地 与 存储 一 致 ， 且 用 户 界面 大 多 处 理 的 是 
Create/Read/Update/Delete(CRUD), 否则 你 必须 考虑 (并 制定 计划 ) 两 个 层面 的 验证 : 呈现 和 业务 。 

在 本 章 的 剩余 部 分 ,我 将 回顾 其 他 一 些 在 ASPNETMVC 系统 中 良好 集成 的 数据 批注 特性 。 
4.3.1 使 用 数据 批注 

如 前 所 述 ， 数 据 批注 是 一 组 特性 ， 可 以 使 用 它们 批注 任何 NET 类 的 公共 属性 ， 以 任意 一 
个 相关 客户 端 代码 可 以 读 取 和 使 用 的 方式 。 特 性 可 以 分 为 两 个 主要 类 别 : 显示 和 验证 。 我 们 
己 经 讨论 了 显示 特性 配合 元 数据 提供 程序 在 ASPNET MVC 中 所 发 挥 的 作用 。 但 是 ， 在 深入 
探究 验证 特性 之 前 ， 让 我 们 先 多 了 解 一 些 有 关 ASPNET MVC 中 数据 验证 的 知识 。 


1. 验证 提供 程序 的 基础 结构 


第 3 章 阐述 了 控制 器 如 何 通 过 模型 绑 定 子 系统 接收 它们 的 输入 数据 。 模 型 绑 定 器 会 把 请 
求 数据 映射 到 模型 类 ， 与 此 同时 ， 它 会 根据 模型 类 上 设置 的 验证 特性 集 对 输入 值 进行 验证 。 

验证 是 通过 提供 程序 实现 的 。 默 认 的 验证 提供 程序 基于 数据 批注 ， 是 
DataAnnotationsModelValidatorProvider 类 。 我 们 看 看 可 以 使 用 哪些 默认 验证 提供 程序 能 够 理 
解 的 特性 。 

表 4-2 列 出 了 模型 类 上 表示 验证 条 件 的 最 常用 数据 批注 特性 。 


表 4-2 用 于 验证 的 数据 批注 特性 


Compare 检查 模型 中 的 两 个 指定 属性 是 侣 具有 相同 值 

CustomValidation 根据 指定 的 目 定 义 函 数 检 得 仁 

EnumDataType 栓 坦 指定 枚 举 类 型 中 的 任意 一 个 值 是 否 可 以 匹配 某 介 

Range 检 得 休 全 是 售 沙 在 指定 区 间 内 。 默 认 是 数 信 型， 不 过 也 可 以 配置 它 以 处 理 日 期 范围 
ResularExpression 检查 条 但 是 否 匹 配 指定 表达 陈 

Remote 执行 一 个 到 服务 器 鸭 Ajax 调用 并 检查 菏 值 是 合 可 以 接收 

Required 栓 得 是 合 为 属性 分 配 了 一 个 非 空 仁 。 可 以 对 其 进行 配置 以 便 分 配 了 衬 值 时 报 铬 
StringLength 检查 字符 串 是 合 超 出 了 指定 长 度 


所 有 这 些 特性 均 从 同一 个 基 类 派生 而 来 ， 那 就 是 ValidationAttribute。 你 很 快 会 发 现 ， 也 
可 以 使 用 此 基 类 来 创建 自 定义 验证 特性 。 

可 以 使 用 这 些 特性 来 修饰 输入 表单 中 正在 使 用 的 类 成 员 。 对 于 整个 运行 机 制 ， 你 需要 有 
在 复杂 数据 类 型 中 接收 数据 的 控制 右 方 法 ， 即 如 下 所 示 的 Memo 控制 器 : 


public ActionResult Edit() 
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{ 
Var memo = new Memo () : 
return View (memo); 

} 

[HLLPPost 1 

public ActionResult Edit (Memo memo) 

{ 
// Modelstate dictionary contains error messages 
// for any invalid value detected according to the annotations 
// you might have in the Memo model class. 
return View (memo);} 

} 


模型 绑 定 器 对 象 会 在 将 传递 值 绑 定 到 Memo 模 型 类 的 同时 编辑 Modelstate 字 典 。 对 于 正在 
映射 到 Memo 类 实例 的 任何 无 效 的 传递 值 ， 绑 定 器 会 目 动 在 ModelState 字 典 中 创建 一 个 条 目 。 
传递 值 是 否 有 效 取 决 于 当前 已 注册 验证 提供 程序 所 返回 的 结 采 。 默 认 的 验证 提供 程序 会 基于 
你 在 Memo 模 型 类 上 设置 的 批注 来 进行 啊 应 。 最 后 ， 如 果 下 一 个 视图 要 使 用 ValidationMessage 
帮助 磺 ， 那 么 错误 消息 会 目 动 显示 。 这 正 是 你 使 用 EditorForModel 创 建 输入 表单 的 情况 。 


2. 修饰 模型 类 


下 面 的 代码 显示 了 一 个 示例 类 一 一 前 面 提 到 过 的 MemoDocument 类 
泛 用 于 验证 : 


它 将 数据 批注 广 


public class MemoDocument : ViewModelBase 


{ 
public MemoDocument () 
{ 
Created = DateTime .Now; 
Category = Categories .Work; 
} 
[Required] 


[stringLength (100) ] 
public String Text { get; set; } 


[Required] 
[Range (1, 2| 
Public Int32 Priority { get; set; } 


[Requilired] 
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public DateTime Created { get; set; } 


[EnumDataType (typeof (Categories))] 
[Required] 


public Categories Category { get; set; } 


[StringLength (50, MinimumLength=4)] 
[ReqularExpression (8@™\b[A—20-—9. $+-—]+@[A—20-—9.—]+\.[A-—2Z] {2,4}\b")] 
public String RelatedEmail { get; set; } 


public enum Categories 
{ 

Work, 

Personal, 

Social 


} 


对 于 这 个 类 , 如 果 Text 属性 超过 100 个 字符 或 者 为 空 , 就 会 收 到 错误 消息 。 同样, Priority 
成 员 必 须 是 介 于 1 和 5( 包 含 1 和 5) 之 间 的 整数 ,日 不 能 省 略 Created 日 期 。 RelatedEmail 成 员 
可 以 为 至 ; 但 是 ， 如 果 指 定 任 何 文本 ， 则 该 文本 必须 介 于 4~50 个 字符 长 上 度 之 则 并 匹配 正则 
表达 式 。 最 后 ，Category 成 员 必 须 包 含 一 个 字符 串 ， 其 会 对 Categories 枚 举 类 型 中 的 一 个 常 
量 进行 估算 。 图 4-11 显示 了 一 个 示例 Memo 的 验证 。 


| ch © 是 http:/ /localhost8515/memo/edit 


图 4-11 验证 消息 
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3. 处 理 枚 举 类 型 
你 可 能 好 奇 为 什么 Category 字段 要 作为 普通 字符 串 来 编辑 。 如 果 能 提供 一 个 下 拉 列 表 ， 


它 会 变 得 更 加 智能 。 但 这 一 效果 费 一 番 周 折 才 能 得 到 。EnumDataType 由 验证 提供 程序 识别 ， 


它 会 确保 值 是 属于 枚 举 的 ， 它 会 被 编辑 器 忽略 。 如 果 想 要 枚 举 值 


的 下 拉 列 表 ， 则 需要 编写 一 


个 String.cshtml 的 自 定义 模板 并 将 其 放 入 EditorTemplates 文件 夹 中 。 因 为 枚 举 类 型 要 与 字符 
串 配对 ， 因 此 你 要 重 写 String.cshtml( 或 .aspx) 以 更 改 枚 举 编辑 的 方式 。 在 代码 中 ， 你 要 根据 
Model 属性 的 实际 类 型 来 确定 标记 。 下 面 是 你 需要 的 简单 代码 : 
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QQmodel Object 
alf (Model 1s Enum) 
{ 
<diy class="editor-field"™> 
QHtml .DropDownList("", new SelectList (Enum.GetValues (Model .GetType()))) 
QHtml .ValidationMessage("") 


</dliv> 
} 
else 
{ 
@Htm]l .TextBox("", ViewData.TemplateInfo.FormattedModelValue., 
new { Qclass = "text-box single-line"™" }) 
} 


图 4-12 显示 了 使 用 刚 创 建 的 编辑 器 模板 时 的 同一 个 表单 。 


€ I®@ 万 http://localhost8515/memo/edit 
Ee | | 


eor message for Tect 


图 4-12 混合 验证 与 显示 数据 批注 
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4. 控制 错误 消息 

在 图 4-12 中 , 可 以 看 到 一 些 说 明 哪里 出 错 的 消息 。 这 些 消息 可 以 由 你 进行 全 面 控制 。 
个 特性 都 有 一 个 ErrorMessage 属性 可 用 来 设置 文本 。 但 是 请 注意 ， 特 性 属性 只 能 接受 常量 字 
侍 串 。 

[Required (ErrorMessage = "A description 1s Tedqulred.")] 

Public String Text { Get sets» 1 

你 可 能 不 喜欢 在 纯 字 符 串 中 穿插 类 定义 的 主意 。 从 错误 消息 中 解 耦 类 定义 的 一 种 方法 是 
使 用 资源 。 使 用 资源 可 使 你 在 不 接触 类 的 情况 下 对 文本 进行 脱 机 和 更改。 它 还 有 助 于 区 域 设 置 ， 
但 它 不 会 提供 对 正在 显示 的 文本 的 编程 控制 。 要 进行 编程 控制 ， 你 唯一 的 选择 是 在 控制 器 方 
法 中 编辑 ModelState 字典 ， 如 下 所 示 : 


A 
or 


[HttpPost] 
public ActionResult Edit (MemoDocument memo) 
{ 
1f (iIModelstate.IsVal1lid) 
{ 
Var newModelstate = new ModelstateDictionary();} 
// Create a new model-state dictionary with values you want to overwrite 
newModelstate.AddModelError("Text™”, "..."); 
newModelstate.AddModelError ("Priority™"™, ™..."™); 
// Merge your changes with the existing Modelstate 
Modelstate.Merge (newModelstate),; 
} 
return View (memo); 


} 
基本 上 ， 你 要 创建 一 个 新 的 模型 状态 字典 ， 然 后 在 模型 绑 定 阶段 将 其 与 计算 过 的 字典 合 
并 。 在 合并 字典 时 ， 新 字典 中 的 值 会 复制 到 ModelState 字典 中 ， 并 覆盖 所 有 的 现 有 值 。 
如 采 有 持续 的 消息 为 你 所 用 ， 那 么 你 需要 做 的 束 是 避免 软件 中 出 现 魔 约 字符 串 ， 可 以 使 
用 资源 文件 ， 顺 便 说 一 下 ， 资 源 文件 还 设置 了 状态 以 便 易 于 区 域 化 。 每 个 验证 特性 都 会 接受 
一 个 表示 为 资源 索引 的 错误 消息 : 
[Redulred (ErrorMessageResourceName="MustSetPriority", 
ErrorMessageResourceType = typeof (StrlIngqs)) ] 
[Range (1, 5, ErrorMessageResourceName="InvalidPriority", 
ErrorMessageResourceType=typeof (Strings))] 
Public Int32 Priority { get; set; } 
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可 通过 两 个 参数 来 表示 资源 : 资源 容器 数据 类 型 和 资源 的 名 称 。 前 者 通过 
ErrorMessageResourceType 属性 来 表示 ; 后 者 由 ErrorMessageResourceName 属性 表示 。 当 在 
ASPNET MVC 项 目 中 添加 一 个 资源 文件 时 ， 微 软 Visual Studio 设计 絮 就 会 创建 一 个 容器 类 
型 ， 将 字符 串 公开 为 公共 成 员 。 这 就 是 要 分 配给 ErrorMessageResourcelype 机 性 区 类 江 ， 默 
认 情 况 下 ， 目 动 生成 其 型 的 名 称 与 资源 (resg) 文 件 的 名 称 是 匹配 的 。 


4.3.2 ”高 级 数据 批注 


数据 批注 的 优点 是 在 你 定义 了 模型 类 型 的 特性 后 ， 蕾 不 多 束 完 事 了 。 后 面 的 任务 几乎 都 
te 多 亏 ASPNET MVC 基础 设施 具有 对 数据 批注 的 深刻 理解 。 然 而 在 这 个 不 完美 的 
， 你 真正 需要 的 东西 都 不 是 那么 容易 就 能 得 到 的 。 数 据 批 注 也 一 样 ， 它 对 不 少 相 对 简单 
机 和 但 在 很 多 真实 的 应 用 程序 中 却 给 你 留 下 了 需要 你 上 自己 去 处 理 的 额外 工 
作 。 接 下 来 我 们 探讨 几 个 可 构建 在 数据 批注 之 上 的 高 级 功能 。 


1. 跨 属性 验证 

到 目前 为 止 我 们 所 理解 的 数据 批注 是 用 于 验证 单个 字段 内 容 的 特性 。 这 当然 是 有 用 的 ， 
但 对 于 现实 情况 下 属性 值 存储 在 男 一 个 属性 中 的 内 容 验 证 ， 它 却 起 不 了 什么 作用 。 跨 属性 验 
证 需要 一 些 特定 于 上 下 文 的 代码 。 问 题 是 : 如 何 编写 代码 以 及 在 哪里 编写 ? 

能 即刻 想到 的 解决 方案 大 致 是 下 面 这 样 的 : 


Public ActionResult Edit (MemoDocument memo ) 


{ 
1f (Modelstate.IsValid) 
{ 
// If here, then properties have been individually validated. 
// Proceed with cross-property validation, and merge model-state 
dictionary 
/1 
// to reflect feedback to the UI. 
} 
} 


如 条 从 绑 定 峰 接收 到 的 模型 状态 是 有 效 的 ， 那 么 所 有 的 修饰 属性 承 都 通过 了 验证 阶段 。 
因此 ， 孤 立地 处 理 每 个 属性 是 可 以 的 。 你 要 继续 进行 特定 于 上 下 文 的 、 跨 属性 的 验证 ， 将 错 
误 添 加 到 新 的 状态 字典 ， 并 将 其 合并 到 现 有 的 ModelState 中 。 

你 可 能 乐于 知道 CustomValidation 特性 正 是 服务 于 这 样 的 目的 ， 总 体 而 言 ， 可 以 将 它 看 
成 我 前 面 推荐 方法 的 快捷 方式 。 思 考 下 面 的 代码 : 
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[Redulredj] 

[EnumDataType (typeof (Catedorles) ) ] 

[CustomValidation (typeof (MemoDocument), "ValidateCategoryAndPriority")] 

Public Categories Category { get; set; } 

CustomValidation 特性 有 两 个 参数 : 分 别 是 类 型 和 方法 名 称 。 类 型 也 可 以 是 你 正在 修饰 的 
同一 个 模型 。 方 法 必须 是 带 有 以 下 签名 的 公共 静态 方法 : 

public static ValidationResult MethodName (Categories category) 

public static ValidationResult MethodName (Categories category, 

ValidationContext context) 

使 用 第 一 个 重 载 等 同 于 定义 用 于 单个 值 的 目 定 义 验证 逻辑 。 某 种 意义 上 相当 于 创建 了 一 
个 自 定义 数据 批注 特性 一 一 这 有 助 于 更 快 地 编写 ， 但 在 签名 方面 比较 严格 。 更 有 趣 的 是 第 二 
个 重 载 。 事 实 上 ， 通 过 ValidationContext 参数 ， 可 以 获得 对 模型 对 象 的 引用 ， 并 可 以 任意 检 


public static ValidationResult ValidateCategoryAndPriority!( 
Categories category, ValidationContext context) 


// Grab the model instance 
Var memo = context.ObjectIinstance as MemoDocument; 
1f (memo == null) 

throw new NullReferenceException (); 


// Cross-property vallidation 
if (memo.Category == Categories.Personal && memo.Priority > 3) 
return new ValidationResult ("Category and priority are not 
consistent.™).:; 
return ValidationResult.SsSuccess; 


} 

可 将 CustomValidation 特性 附加 到 一 个 单独 的 属性 ， 也 可 以 附加 到 类 。 在 前 面 的 示例 中 ， 
该 特性 是 附加 到 Category 的 , 但 它 要 确保 如 果 值 是 Personal， 则 Priority 属性 必须 设置 成 不 大 
于 3 的 值 。 如 果 验 证 失败 ， 那 么 模型 状态 字典 中 的 条 目 会 把 Category 用 作 键 值 。 如 条 把 
Customvalidation 附加 到 类 ， 则 要 注意 ， 只 有 当 所 有 的 单个 属性 都 不 出 问题 ， 验 证 才 会 执行 。 
这 正 是 前 面 所 介绍 的 模式 的 声明 性 对 应 : 

[CustomValidation (typeof (MemoDocument), "ValidateMemo")] 


public class MemoDocument 
{ 
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下 面 是 CustomValidation 特性 附加 到 类 时 所 对 应 的 方法 签名 : 


public static ValidationResult ValidateMemo (MemoDocument memo) 
{ 


} 


当 你 在 类 级 别 使 用 CustomValidation 时 ， 会 遇 到 捕获 错误 消息 的 问题 ， 因 为 错误 消息 通 


种 与 属性 相关 联 。 可 以 使 用 Html.ValidationSummary 帮助 器 ， 它 会 将 所 有 的 错误 消 恩 提取 出 


无 论 是 否 为 原始 属性 ， 从 而 轻松 地 解决 掉 这 个 问题 。 本 章 稍 后 将 讨论 类 级 别 验证 的 主题 。 
最 后 ，Compare 特性 可 用 来 更 快速 地 服务 于 具体 的 跨 属 性 方案 ， 比 如 ， 当 你 需要 确保 一 


个 属性 的 值 与 另 一 个 属性 的 值 相 匹 配 时 。 典 型 的 例子 是 重新 键入 一 个 新 密码 : 


[Redulredj] 
[DataType (DataType.Password)l| 
public String NewPassword {get; set;} 


[Required] 

[DataType (DataType.Password)l] 

[Compare ("NewPassword"™|) 

public String RetypePassword {get; set;} 

这 一 比较 是 通过 在 特定 类 型 上 使 用 Equals 方法 来 实现 的 。 

2. 创建 自 定 义 验证 特性 

CustomValidation 特性 会 强制 你 在 不 增加 任何 额外 参数 的 前 提 下 验证 存储 在 属性 中 的 值 。 问 


题 是 没有 足够 多 的 对 模型 对 象 上 其 他 属性 的 访问 权 一 而 这 个 问题 在 使 用 ValidationContext 
是 不 会 遇 到 的 一 - 却 丰富 了 那些 定义 了 附加 特性 级 别 参数 的 特性 的 签名 。 例 如 ， 假 设 你 要 验 
证 一 个 数字 以 确保 它 是 偶数 。 另 外 根据 需要 , 你 还 要 打开 这 个 特性 检查 它 是 否 也 是 4 的 倍数 。 
这 时 你 需要 一 个 如 下 所 示 的 特性 : 
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[EvenNumber (MultipleOf4=true)] 
public Int32 MagicNumber {get; set;} 


没有 办 法 在 由 CustomValidation 所 识别 的 签名 中 传递 一 个 可 选 的 Boolean 值 。 最 终 要 说 


的 是 ，CustomValidation 特性 与 自 定义 验证 特性 之 间 的 区 别 是 后 者 的 日 的 在 于 易于 重复 使 用 。 
下 面 显 示 了 如 何 编写 一 个 自 定义 数据 批注 特性 : 


[AttributeUsage (AttributeTargets .Property)] 
Public class EvenNumberAttribute : ValidationAttribute 
{ 
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// Whether the number has to be checked also for being a multiple of 4 
public Boolean Multipleof4 { get; set; } 


public override Boolean IsValid(Object value) 
{ 
1f (value == null) 
return false; 


X= (INt32) Value， 
} 
catch 
{ 

return false; 


} 


1f (x SS 2 > 0) 
return false; 

1f (!Multipleof4) 
return true,; 


// Is multiple of 4? 


性 


return (x Sb 4 == 0); 


} 
你 要 创建 一 个 从 ValidationAttribute 继承 的 类 ， 并 重 写 IsValid 方法 。 如 果 需 要 额外 的 参 
数 ， 比 如 MultipleOf4， 就 定义 公共 属性 吧 ，。 
在 ASPNET MVC 中 ,可 以 创建 执行 跨 属 性 验证 的 自 定义 特性 。 你 只 需要 重 写 IsValid 方 
法 的 重 载 ， 使 其 和 加 改变 : 


protected override ValidationResult IsValid(Object value, ValidationContext 
context) 


使 用 ValidationContext 对 象 上 的 属性 ， 可 以 获得 对 整个 模型 对 象 的 访问 ， 从 而 执行 充分 
的 验证 。 


3. 局 用 客户 端 验证 
所 有 示例 处 理 的 都 是 贯穿 一 个 回 传 或 Ajax 表单 的 任务 。 要 将 其 与 Ajax 一 起 使 用 ， 你 只 
需要 对 显示 编辑 器 的 视图 做 一 点 小 的 更 改 ， 以 便 它们 使 用 Ajax.BeginForm 而 非 
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HtmlLBeginForm。 另 外 ， 控 制 需 方 法 应 该 返回 一 个 部 分 视图 而 不 是 完整 视图 ， 如 下 所 示 : 


[HELPPost | 
public ActionResult Edit (MemoDocument memo ) 
{ 
1f (Request.IsAJjaxRequest () ) 
return PartialView ("edit ajax", memo); 
return View (memo); 
} 


下 面 的 代码 显示 了 如 何 将 原始 视图 转换 成 edit ajax 部 分 视图 : 


QQmodel DataAnnotations .ViewModels .Memo .MemoDocument 
@1f 
Layout = "™; // Drop the master Page 


ausing (Ajax.BeginForm("edit", "memo", 
new AJjaxoptions() { UpdateTargetId="memoEditor™ })) 


<div lid="memoEditor"™"> 

<fieldset> 
<legend>Memo</ legend> 
QHtml .EditorForModel () 
RS 
<input type="submit"™" value="Create"™ /> 
</p> 

</fieldset> 

</div> 

} 


以 这 种 方式 ， 你 的 表单 就 会 在 服务 器 上 进行 验证 ， 但 不 会 刷新 整个 页 面 。 然 而 ， 至 少 对 
于 某 些 基本 批注 来 说 ， 这 有 助 于 开局 客户 端 验证 ， 以 便 在 数据 是 明显 无 效 时 (例如 ， 所 需 的 字 
段 为 空 ) 不 会 后 动 HTTP 请 求 。 
要 开启 客户 端 验证 ， 需 要 执行 几 个 简单 的 步 又。 首先 ， 确 保 你 的 web.config 文件 包含 以 
下 内 容 : 
<appSsettings> 
<add key="ClientVvalidationEnabled"™" value="true"™" /> 


<add key="UnobtrusiveJavascriptEnabled"™" value="true"™" /> 
</appsSettings> 
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注 总 : 

这 两 个 设置 都 是 默认 设置 ,此 外 ,你 需要 链接 两 个 JavaScript 文件 : jquery.validate.js(jQuery 
验证 插件 ) 和 jquery.validate.unobtrusive.js， 或 者 它们 的 压缩 版 。 查找 和 添加 这 些 文件 的 最 简单 
方法 是 NuGet。 不 用 说 ， 当 务 之 急 就 是 链接 jQuery 库 。 

重要 所 示 : 

当 你 开启 客户 端 验证 时 ， 所 有 内 置 的 数据 批注 特性 都 会 获得 一 个 客户 端 行为 ， 并 尽 可 能 
在 浏览 器 中 执行 其 在 JavaScript 中 的 验证 。 如 果 验 证 失败 ， 就 不 会 向 Web 服务 器 发 出 请 求 。 
然而 ， 像 EvenNumber 一 样 的 自 定 义 验证 特性 不 会 自动 照 此 原理 工作 。 要 添加 用 于 自 定义 特 
性 的 客户 端 验证 ， 你 还 需要 实现 一 个 额外 的 接口 ， 即 IClientValidatable， 这 会 在 后 面 讲 到 。 

4. 基于 文化 的 客户 端 验证 


i 你 可 能 会 遇 到 额外 的 全 局 化 问题 。 例 如 ， 请 思考 下 面 的 


= 


public Decimal Price {get; set;} 

编辑 器 会 正确 处 理 类 型 ， 并 显示 “0.00” 的 默认 格式 。 然 而 ， 如 果 输 入 “0,8”， 将 逗号 
作为 小 数 点 分 隔 符 ， 那 么 你 的 输入 将 被 拒绝 ， 表 单 不 会 提交 。 可 以 看 到 ， 设 置 客 户 端 验 证 上 
的 正确 区 域 性 是 一 个 问题 。jQuery Validation 插件 在 客户 端 上 献 认 为 美国 区 域 设 置 ， 相反 ， 在 
服务 需 端 ， 它 取决 于 线程 上 Culture 属性 的 值 (参见 第 5 章 “ASPNET MVC 应 用 程序 的 特性 ” 
有 关 区 域 设置 和 全 局 设置 的 详细 信息 )。 

要 文 持 客户 端 上 的 条 指定 区 域 ， 必须 自 先 链 接 官方 ]Query 全 局 设置 插件 ， 以 及 你 想 要 的 
指定 区 域 的 脚本 文件 。 在 常规 验证 脚本 之 后 必须 包含 这 两 个 文件 。 此 外 ， 必 须 指示 全 局 设置 
插件 你 要 使 用 哪个 区 域 。 最 后 ， 必 须 告知 验证 程序 插件 ， 当 它 解 析 数 字 时 需要 使 用 全 局 设置 
信息 。 


<ScCript type="text/Javascript"> 
$ .validator.methods.number = function (value, element) { 
if (Globalization.parserFloat (value)) 1 
return true,; 
} 
return false; 
} 
$ (document) .ready (function () { 
$ .culture = jQuery-.cultures["'it-—IT"']; 
$s.preferCculture($.culture.name); 
Globalization.preferCulture($.culture.name); 
}); 
</script> 
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有 了 此 代码 后 ， 就 可 以 使 用 指定 区 域 设置 来 输入 小 数 。 进 一 步 使 用 此 方法 ， 就 可 以 在 区 
域 基础 上 自 定义 大 部 分 的 客户 端 验证 工作 。 


5. 远程 验证 属性 


验证 可 能 发 生 在 客户 端 上 ， 但 你 应 该 把 它 看 作为 页 面 避 免 一 些 高 强度 HITP 请 求 的 一 种 
方式 。 为 安全 起 见 ， 你 应 该 始终 验证 服务 器 上 的 所 有 数据 。 然 而 ， 要 给 用 户 带 来 更 好 的 体验 ， 
你 会 布 望 在 不 离开 浏览 堪 的 情况 下 执行 服务 嚣 端 验证 。 典 型 的 例子 是 当 用 户 注册 某 个 服务 并 
输入 昵称 之 时 。 该 名 称 必 须 是 唯一 的 ， 而 其 唯一 性 只 能 在 服务 右上 进行 验证 。 如 有 果 可 以 实时 
告知 用 户 该 昵称 是 售 已 被 使 用 ， 是 不 是 很 酷 呢 ? 这 样 一 来 ， 用 户 便 能 及 时 更 改 ， 并 且 避 免 在 
提交 注册 请 求 时 出 现 恼人 的 意外 。 

数据 批注 提供 了 一 个 有 助 于 此 功能 编码 的 特性 : Remote 特性 。 附 加 到 一 个 属性 ， 该 特性 
就 能 调用 某 控 制 器 上 的 方法 并 预期 一 个 Boolean 响应 。 该 控制 器 方法 会 接收 要 验证 的 值 以 及 
一 个 额外 的 相关 字段 列表 。 下 面 是 一 个 示例 : 

[Remote (ChecKCustomer- ， “Memo 

AdditionalFields="Country", 
ErrorMessage="Not an exlsting customer")] 

Public String RelatedCustomer { get; set; } 

当 在 客户 端 上 验证 RelatedCustomer 时 ， 代 码 会 隐 式 地 把 jQuery 调用 放置 到 Memo 控制 
器 上 的 CheckCustomer 方法 。 如 果 响 应 是 否定 的 ， 则 显示 指定 的 错误 消息 。 


public ActionResult CheckCustomer (String relatedCustomer) 


{ 
1f (CustomerRepository.Exists (relatedCustomer)) 
return Json(true, JsonRequestBehavior.AllowGet); 
return Json(false, JsonRequestBehavior.AllowGet); 
} 


该 控制 大 必须 返回 封 构 在 一 个 JSON 有 效 载 丛 内 的 true/false。 如果 已 经 指定 了 附加 字段 ， 
则 它们 会 被 添加 到 URL 的 查询 字符 串 并 遵循 ASPNET MVC 的 经 典 模型 绑 定 规则 。 多 个 字段 
要 用 逗 写 阳 开 。 下 面 是 一 个 URL 示例 : 

http://yourserver/memo/checkcustomer?relatedCustomer=dino&Country=... 

每 一 次 输入 字段 在 被 修改 后 失去 焦点 的 时 候 ， 就 会 触及 Ajax 调用 。 以 Remote 特性 修饰 
的 属性 会 接受 客户 端 验证 约定 ， 并 且 在 输入 一 个 有 效 值 之 前 不 允许 表单 回 传 。 

重要 所 示 : 

数据 批注 在 编译 时 只 能 衣 态 指定 。 目 前 ， 尚 没有 办 法 从 外 部 数据 源 读 取 特 性 并 将 它们 绑 
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定 到 运行 中 的 模型 属性 。 要 开启 此 功能 ， 你 可 能 需要 考虑 用 一 种 可 以 从 不 同 源 中 读 取 元 数据 
进行 验证 的 自 定 义 验 证 提供 程序 ， 和 替换 掉 默 认 的 验证 提供 程序 。 

我 发 现 相 较 于 表示 层 ， 这 和 更 像 是 业务 层 验 证 的 现实 问题 。 在 业务 层 验证 中 ， 随 着 需求 的 
变化 ， 你 可 能 需要 注入 业务 规则 ， 同 时 也 需要 更 大 的 灵活 性 。 在 业务 层 验证 中 ， 我 经 第 使 用 
企业 库 验 证 应 用 程 友 块 (Enterprise Library Validation Application Block)， 它 可 以 从 配置 文件 中 
读 取 验 证 特性 ( 稍 后 会 回头 来 探讨 企业 库 )， 

4.3.3 ”自我 验证 

数据 批注 会 试图 将 正在 从 表单 传递 的 数据 验证 过 程 自动 化 。 大 多 数 时 候 ， 你 只 会 使 用 党 
备 特 性 ， 并 晶 不 费力 地 获得 错误 消息 。 在 其 他 情况 下 ， 你 需要 以 稍微 高 一 点 的 开发 成 本 创建 
自己 的 特性 ， 但 这 样 做 的 同时 也 创建 了 非常 适应 现 有 基础 设施 的 组 件 。 此 外 ， 数 据 批 注 的 目 
的 在 于 大 多 数 时 候 在 属性 级 别 工 作 。 在 ASPNET MVC 中 ， 你 始终 可 以 通过 验证 上 下 文 来 访 
问 整 个 模型 ， 然 而 ， 最 后 当 验 证 变 得 复杂 时 ， 许 多 开发 人 员 宁 愿 选择 一 个 手工 定制 的 验证 
层 。 

换 句 话说 ， 你 要 停止 众多 数据 批注 组 合 中 的 分 隅 验证 ， 并 将 所 有 处 理 任 务 移 到 一 个 单独 
的 地 方 一 一 一 种 从 控制 占 内 的 服务 右上 调用 的 方法 : 

public ActionResult Edit (MemoDocument memo) 

{ 


1f (IValidate (memo)) 
Modelstate.AddModelError{(...):; 


} 


MemoDocument 类 可 能 有 也 可 能 没有 属性 批注 。 以 我 看 来 ， 如 果 选 择 自 我 验证 ， 为 明确 
起 见 你 应 该 停止 使 用 数据 批注 。 不 过 在 任何 情况 下 ， 上 自我 验证 都 不 会 阻止 你 使 用 数据 批注 。 


1. IValidatableObject 接口 


在 面 对 构 建 自 我 验证 层 的 任务 时 ， 可 以 发 挥 你 的 创造 力 ， 并 选择 最 适合 你 的 应 用 程序 模 
型 。ASPNET MVC 会 试图 推荐 一 种 方法 。 基 本 上 ，ASPNET MVC 会 保证 任何 实现 
IValidatableObject 接口 的 模型 类 都 会 自动 验证 , 无 须 开 发 人 员 显 式 调用 验证 。 该 接口 如 下 所 示 : 

Public interface IValidatableObject 


{ 
IEnumerable<ValidationResult> Validate (ValidationContext 
validationContext); 


} 
如 果 检 测 到 了 接口 ， 验 证 提供 程序 会 在 模型 绑 定 步骤 期 间 调 用 Validate 方 法 。 
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ValidationContext 类 型 的 参数 使 整个 模型 可 用 于 任何 类 别 的 路 属性 验证 。 


重要 提示 : 
如 果 模 型 也 被 数据 批注 修饰 ， 其 中 某 些 属性 没有 处 于 有 效 状 态 ， 则 不 会 调用 Validate 方 
法 (为 了 避免 错误 ， 如 果 选 择 了 IValidatableObject， 我 建议 你 完全 放弃 数据 批注 )。 


使 用 IValidatableObject 在 功能 上 等 同 于 在 类 级 别 上 使 用 CustomValidation 特性 。 唯 一 的 
区 别 是 有 了 IValidatableObject， 就 可 以 在 使 用 你 自己 的 架构 并 维持 数据 批注 独立 性 的 情况 下 ， 
利用 单个 方法 实现 一 个 验证 层 。 


2. 集中 式 验 证 的 优势 


当 你 有 非常 复杂 的 验证 逻辑 ， 其 中 路 属性 验证 占 主 导 地 位 时 ， 将 每 个 属性 的 验证 和 类 级 
别 的 验证 混合 可 能 会 引发 最 终 用 户 不 居 快 的 经 历 。 如 前 所 述 ， 在 所 有 属性 都 单独 得 到 了 验证 
前 ， 不 会 局 动 类 级 别 的 验证 。 这 就 是 说 用 户 最 初 会 看 到 几 个 与 属性 相关 的 错误 消息 ， 随 后 只 
要 这 些 错误 被 修改 ， 用 户 就 会 认为 这 些 错误 是 无 碍 的 。 相 反 ， 他 们 可 能 会 因为 跨 属 性 验证 而 
获得 一 个 全 新 的 错误 组 。 用 户 完全 不 会 知道 其 他 的 可 能 错误 ， 除 非 它 们 显示 出 来 。 为 了 避免 
这 一 点 ， 如 果 类 级 别 的 验证 占 主导 地 位 ,就 请 关注 类 级 别 验证 , 减少 对 每 个 属性 验证 的 关注 。 

要 实现 类 级 别 验证 ， 在 类 级 别 进行 TValidatableObject 和 CustomValidation 之 间 的 选择 完 
全 取决 于 你 。 多 年 来 ,我 都 使 用 自己 的 接口 ， 它 看 上 去 就 和 今天 的 TValidatableObject 几乎 一 
模 一 样 。 


3. IClientValidatable 接口 


当 客 户 亲 验证 处 于 活动 状态 时 ， 自 定义 验证 特性 不 会 产生 任何 明显 的 效果 。 换 句 话 说 ， 
目 定 义 特性 本 号 不 能 运行 任何 客户 端 代码 来 验证 浏览 器 中 的 值 。 然 而 并 不 是 说 你 不 能 添加 这 
种 能 力 。 只 是 它 需 要 更 多 代码。 下 面 是 如 何 扩展 日 定义 特性 从 而 为 客户 端 启 用 这 种 能 力 的 
代 体 : 

AttributeUsage (AttributeTargets.Property)] 

public class ClientEvenNumberAttribute : ValidationAttribute, 


IClientvalidatable 
{ 


// IClientVvalidatable interface members 

public IEnumerable<ModelCclientVvalidationRule> GetClientVvalidationRules!( 
ModelMetadata metadata, ControllerContext context) 

{ 


Var errorMessage = ErrorMessadge; 
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1f (String.IsNulloOrEmpty (errorMessage)) 
errorMessage = (MultipleOf4 ? Multipleof4ErrorMessage : 
EvenErrorMessage); 


Var rule = new ModelClientVvalidationRule 
{ 
validationType = "liseven", 
brrorMessage = errorMessage 
}; 
rule.VvalidationParameters.Add ("multipleof4", Multipleof4); 
yield return rule; 


} 

你 只 需要 让 它 实现 一 个 新 的 接口 : IClientValidatable 接口 。 该 方法 会 返回 一 个 验证 规则 
集 。 每 个 规则 都 具有 一 条 错误 消息 、 一 个 用 于 验证 的 JavaScript 函数 名 以 及 一 个 JavaScript 
代码 的 参数 集 的 特征 。 参 数 和 函数 名 称 要 小 写 。 

接着 ,你 要 编写 一 些 在 客户 端 执 行 验证 的 JavaScript 代码。 最 好 退 过 使 用 ]Query 和 jQuery 
验证 插件 来 编写 ,下面 是 局 用 先前 要 在 客户 端 运 行 的 EvenNumber 特 性 所 需 的 JavaScript 代 码 : 


$.vallidator.addMethod('"'iseven', function (value, element, params) { 
Var mustBeMultipleof4 = params .multipleofd4d; 
1f (mustBeMultipleOf4) 
return (value $$ 4 === 0)，} 
return (value $$ 2 === 0); 


})5s 


$s .validator.unobtrusive.adapters.add('iseven', ['multipleof4", 
‘more parameters |] ， 
function (options) { 
options.rules['iseven'] = options .params; 
options.messages['iseven'] = options.message; 
}); 
addMethod 函数 会 注册 执行 iseven 规则 的 验证 回调 。 验 证 回调 会 接收 要 验证 的 值 和 先前 
添加 到 IClientValidatable 实现 中 的 规则 的 所 有 参数 。 
另外， 你 需要 指定 适 配 颖 来 生成 JavaScript 目 由 标记 的 验证 方案 。 添 加 适配器 需要 你 指 
明 孙 数 的 名 称 、 其 参数 和 错误 消息 。 
不 再 需要 其 他 任何 东西 了 ; 如 果 它 常 运行 ， 首 先 检查 所 需 的 脚本 是 否 都 可 用 ， 然 
后 检查 JavaScript 代码 中 和 Maan C# 实 现 中 函数 和 参数 的 名 称 。 请 注意 如 果 出 
现 什 么 问题 ， 你 也 不 会 收 到 任何 JavaScript 错误 。 
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4. 动态 服务 器 端 验证 


验证 就 是 带 有 条 件 的 代码 ， 因 此 最 终 ， 它 就 是 把 一 些 证 语句 和 返回 的 Boolean 值 结合 在 
起 。 用 纯 代码 编写 验证 层 ， 不 使 用 任何 专用 框架 或 技术 在 实践 中 也 许可 行 ， 但 在 设计 上 未 
必 是 个 好 点 子 。 这 样 编写 的 代码 会 很 难 读 ， 也 难以 扩展 ， 即 使 最 近 发 布 的 流畅 代码 库 能 使 它 
变 得 稍 容易 一 些 。 
受制 于 实际 业务 规则 , 验证 是 一 个 极 不 稳定 的 过 程 , 并 且 你 的 实现 必须 要 考虑 到 这 一 点 。 
最 终 ， 这 不 仪 与 编写 验证 代码 有 关 ， 还 与 要 用 于 针对 不 同 规则 的 相同 数据 验证 代 人 码 有 关 。 数 
据 批 注 是 一 个 可 能 的 选择 ， 男 一 种 有 效 选 择 是 微软 企业 库 中 的 验证 应 用 程序 块 (Validation 
Application Block, VAB). 
数据 批注 和 VAB 有 许多 共同 之 处 。 两 个 框架 都 基于 特性 , 且 都 可 以 使 用 表示 目 定 义 规 则 
pn eet 这 两 种 情况 下 ， 你 都 可 以 定义 跨 属 性 验证 。 最 后 ， 两 个 框 染 都 有 一 
验证 程序 API， 用 于 评估 实例 并 返回 错误 的 列表 。 那 么 ， 区 别 在 哪里 呢 ? 
数据 批注 是 .NET Framework 的 一 部 分 ， 并 且 不 需要 任何 单独 的 下 载 。 企 业 库 是 一 个 单独 
的 NuGet 包 。 它 在 大 型 项 目 中 可 能 算 不 了 什么 ， 但 仍 有 一 个 问题 ， 因 为 在 茶 些 企业 方案 中 可 
能 还 需要 额外 的 申请 批准 。 
在 我 看 来 ，VAB 有 一 方面 是 优 于 数据 批注 的 : 它 可 以 通过 XML 规则 集 充 分 配置 。XML 
规则 集 是 配置 文件 中 的 一 个 条 目 ， 可 以 按照 需要 在 其 中 摘 述 验证 。 更 不 用 说 ， 可 用 声明 方式 
进行 更 改 甚 至 不 用 触及 你 的 代码 。 下 面 是 一 个 规则 集 的 示例 。 


<vallidation> 
<type assemblyName="..." name="Samples.DomainModel] .Customer"> 
<ruleset name="IsValidForReglistration"™> 
<properties> 


<property name="CompanyName"> 
<validator type="NotNullValidator™ /> 
<validator lowerBound="6" lowerBoundType="Ignore" 
upperBound="40"™"™ upperBoundType="Inclusive" 


messageTemplate="Company name cannot be longer ..." 
type="StringLengthvalidator™ /> 
</property> 


<property name="1Id"> 
<validator type="NotNullVvalidator™ /> 
</property> 
<property name="PhoneNumber™"> 
<vallidator negated="false" 
type="NotNullVvalidator™ /> 
<validator lowerBound="0™ lowerBoundType="Ignore" 
upperBound="24™ upperBoundType="Inclusive" 
negated="false" 
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type="StringLengthVvalidator™ /> 
</property> 


0 
</ruleset> 
</type> 
</validation> 
规则 集 列 出 了 你 希望 应 用 于 指定 类 型 上 的 指定 属性 的 特性 。 要 在 代码 中 验证 规则 集 ， 可 
以 参考 如 下 的 代码 


public virtual ValidationResults ValldateForRed1l1strat1lon() 


| 
Var validator = ValidationFactory 
.CreateValidator<Customer> ("IsVallidForRegistration™); 
Var results = validator.Validate (this); 
return results,; 
} 


上 述 方法 会 将 列 在 IsValidForRegistration 规则 集中 的 验证 程序 应 用 到 该 类 的 指定 实例 
(ValidateForRegistration 方法 将 成 为 你 的 实体 类 上 的 一 个 方法 )。 


注意 : 

有 两 种 验证 途径 : 有 时 ， 如 果 传 递 了 无 效 数据 你 希望 将 其 暴露 出 来 ; 而 有 时 ， 你 想 要 收 
集 错误 并 将 其 报告 给 代码 的 其 他 层 . 在 .NET 中 , 代码 约定 是 你 会 愿意 纳入 验证 用 途 的 另 一 项 
技术 。 然 而 ， 不 同 于 批注 和 WVAB， 人 代码 约 定 只 会 检查 条 件 ， 然 后 在 第 一 次 失败 时 抛 出 异 第 。 
你 需要 使 用 一 个 集中 的 错误 处 理 程 序 以 便 从 异 第 中 恢复 ， 并 合理 地 降级 运行 。 一 般 情 况 下 ， 
我 会 建议 只 在 捕获 潜在 的 可 能 导致 不 一 致 状态 的 严重 错误 时 才 在 域 实体 中 使 用 代码 约定 。 例 
如 ， 在 工厂 方法 中 使 用 代码 约定 就 不 错 。 这 种 情况 下 ， 如 果 向 该 方法 传递 明显 无 效 的 数据 ， 
你 会 想 要 它 抛 出 一 个 异 第 。 是 否 也 在 属性 的 设 定 方法 中 使 用 代码 约定 由 你 自己 决定 。 我 宁愿 
走 温 和 路 线 ， 通 过 特性 进行 验证 。 


4.4 本 章 小 结 


输入 表单 在 任何 Web 应 用 程序 中 都 很 常见 , 当然 在 ASPNET MVC 应 用 程序 中 也 不 例外 。 
曾经 有 一 段 时 间 ， 业 界 有 一 种 意见 认为 ASPNET MVC 并 不 适合 用 来 支持 数据 驱动 的 应 用 程 
序 ， 因 为 它们 需要 大 量 的 数据 输入 和 验证 。 最 终 ，ASPNET MVC 将 任务 完成 地 很 好 。 它 使 
用 了 一 组 与 Web Forms 不 同 的 工具 ， 但 是 也 很 有 效 和 简明 扼要 。 

ASPNET MVC 为 模板 化 帮助 器 提供 了 自动 生成 的 重复 性 表单 以 及 服务 器 端 和 客户 端 表 
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单 的 输入 验证 。 如 果 构 建 自己 的 围绕 以 显示 和 验证 特性 批注 的 视图 模型 对 象 的 用 户 接口 ， 可 
在 很 大 程度 上 简化 输入 验证 。 这 些 特性 一 一 称 为 数据 批注 一 一 由 ASPNET MVC 基础 设施 ( 模 
型 元 数据 和 验证 提供 程序 ) 识 别 ， 并 被 处 理 以 用 于 生成 模板 化 帮助 器 并 为 用 户 反 馈 消 息 。 

在 这 一 章 ， 我 们 几乎 介绍 了 ASPNET MVC 编程 的 所 有 基础 内 容 。 第 5 章 主要 涉及 一 些 
待 处 理 的 问题 ， 包 括 区 域 设 置 、 安 全 和 与 内 部 对 象 的 集成 ， 主 要 是 会 话 和 缓存 。 


第 || 部 分 


ASP.NET MVC 软件 设计 
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宙 


ASP.NET MVC 应 用 程序 的 特性 


统治 者 过 多 全 无 益处 。 一 国 应 当 只 有 一 位 统治 者 ， 一 位 君王 。 


——Homer 


Web 应 用 程序 不 仅仅 只 是 一 系列 的 请 求 / 啊 应 而 已 。 如 果真 的 如 此 简单 的 话 ， 那 么 拥有 一 
套 成 熟 的 ASPNET MVC 控制 器 ， 就 已 做 好 了 万 全 准备 。 然 而 事实 往往 更 复杂 一 些 。 一 个 有 
效 的 ASPNET MVC 应 用 程序 来 自 于 对 方方面面 的 深刻 考量 和 实现 ， 包 括 搜 索引 擎 优化 
(Search Engine Optimization，SEO)、 状 态 管 理 、 销 误 处 理 ， 以 及 本 地 化 等 (这 里 仅仅 列 示 了 一 
些 比较 重要 的 方面 而 已 )。 

这 一 章 是 截然 不 同 且 在 某 种 程度 上 上 自 包 含 的 主题 集合 ， 每 个 主题 都 涉及 市 面 上 众多 
ASPNET MVC 应 用 程序 已 经 具有 或 正 考虑 实现 的 一 个 特性 。 


注意 : 

不 是 每 个 Web 应 用 程序 都 需要 管理 会 话 或 全 局 状态 。 同 样 ， 并 不 是 每 个 应 用 程序 都 是 为 
国际 用 户 所 编写 或 者 重视 在 搜索 引擎 中 靠 前 的 排名 。 然 而 话 虽 如 此 ， 我 却 想 不 出 一 个 不 需要 
所 有 这 些 特 性 的 应 用 程序 来 。 


5.1 ASP.NET 内 部 对 象 


ASPNET MVC 是 在 ASPNET 基础 架构 之 上 运行 和 发 展 起 来 的 。 在 很 大 程度 上， 可 以 把 
ASPNET MVC 视 为 经 典 ASPNET 运行 时 环境 的 特别 版 本 ， 其 仅 用 于 文 持 不 同 的 应 用 程序 和 
编程 模型 。ASPNET MVC 应 用 程序 对 构成 ASPNET 生态 系统 的 任何 内 置 组 件 都 具有 完全 访 
问 权 ， 包 括 Cache、S$ession、Response， 以 及 有 身 份 验证 和 销 误 处 理 层 。 

在 ASPNET MVC 中 访问 这 些 组 件 的 方式 没有 什么 不 同 。 但 要 从 ASPNET MVC 内 部 使 
用 这 些 组 件 呢 ? 对 这 个 问题 的 描述 正 是 这 一 章 的 目的 所 在 。 
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注意 : 

在 ASPNET 中 一 一 包括 这 本 书 中 一 一 “内 部 对 得” 或 是 “内 部 ”的 表达 第 第 用 于 表示 封 
六 在 HttpContext 中 的 整个 基础 对 象 集 。 包 括 HttpRequest、HttpResponse、HttpSessionState、 
Cache 和 用 于 标识 已 登录 用 户 的 对 芥 ， 


5.1.1 HTTP 响应 和 SEO 


让 我 们 从 HttpResponse 对 象 开 始 分 析 ASPNET 内 部 对 象 。 该 对 象 用 来 描述 在 请 求 处 理 
结束 时 回 传 给 浏览 器 的 HITP 啊 应 。 HttpResponse 对 象 的 公共 接口 可 以 让 你 设置 cookies 和 内 
容 类 型 、 附 加 标 头 ， 以 及 针对 啊 应 数据 的 缓存 将 指令 传递 给 浏览 器 。 另 外 ，HttpResponse 对 
象 还 有 助 于 重 定 问 到 其 他 URL。 

要 对 响应 流 的 任何 一 方面 进行 自 定 义 ， 你 需要 号 一 个 自 定 义 操作 结果 对 象 ， 并 让 控制 器 
方法 返回 你 的 类 型 的 一 个 实例 ， 而 不 是 ViewResult 或 其 他 从 ActionResult 派生 而 来 的 预定 义 
类 型 的 实例 。 第 8 章 “ 自 定义 ASPNET MVC 控制 器 ”中 会 详细 讨论 这 方面 的 内 容 。 

SEO 是 我 们 要 更 多 关注 ASPNET HttpResponse 对 象 特征 的 一 个 极其 正当 的 理由 。 永 和 久 重 
定向 是 首 个 需要 考虑 的 实际 编程 特性 。 


1. 永久 重 定 向 


在 ASPNET 中 ， 当 你 调用 Response.Redirect 时 ， 会 同 浏 览 器 返回 一 个 HITP 302 代码 ， 
表明 所 请 求 的 内 容 现在 可 以 从 另 一 个 指定 位 置 获 得 。 在 此 基础 上 ， 浏 览 器 会 问 指 定 地 址 发 送 
第 二 个 请 求 并 获取 内 容 。 但 是 , 访问 你 页 面 的 搜索 引擎 会 切实 得 到 HITP 302 代码 。 HTTP 302 
状态 人 码 的 实际 意思 是 所 请 求 的 页 面 已 暂时 移 到 新 地 址 。 其 结果 是 , 搜索 引擎 不 会 更 新 内 部 表 ， 
所 以 当 以 后 菜 人 单 击 得 看 你 的 页 面 时 ， 引 擎 会 返回 原始 地 址 。 这 样 一 来 ， 浏 览 嚣 就 会 收 到 一 
个 HTTP 302 代码 ， 并 需要 发 出 第 二 个 请 求 ， 以 最 终 显 示 所 需 的 页 面 。 


注意 : 
要 了 解 HTTP 返回 代码 以 及 它们 是 如 何 工作 的 更 多 内 容 ， 请 查看 一 个 不 错 的 资源 
http://www.w3.org/Protocols/r{c2616/rfc2616-sec10.html, 


如 果 重 定向 用 于 传送 一 个 给 定 URL 的 请 求 , 永久 重 定向 就 是 一 个 更 好 的 选择 , 因为 它 对 
于 搜索 引擎 来 说 代表 着 一 条 更 丰厚 的 信息 。 要 设置 永久 重 定向 ， 需 要 返回 HTTP 301 响应 代 
码 。 该 代码 会 告知 搜索 代理 ， 位 置 已 被 永久 移动 。 搜 索引 擎 知道 如 何 处 理 HTTP 301 代码 ， 
并 使 用 这 些 信息 来 更 新 该 页 面 URL 的 引用 。 当 下 一 次 它们 显示 涉及 页 面 的 搜索 结果 时 , 链接 
的 URL 就 是 新 的 。 用 这 种 方式 ， 用 户 可 以 快速 到 达 页 面 ,避免 了 第 二 次 往返 。 下 面 的 代码 显 
示 了 如 何以 编程 方式 设置 一 个 永久 重 定向 : 


Vold PermanentRedirect (String url, Boolean endRequest) 
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Response.Clear (}; 
Response -statuscodade = 301; 
Response.AddHeader ("Location™", url); 


// Optionally end the request 
if (endRequest) 
Response.End()}; 

} 

从 ASPNET 4 开始 ，HttpResponse 类 的 特征 便 是 对 类 似 的 事情 采用 一 种 新 方法 。 该 方法 
的 名 称 是 RedirectPermanent。 使 用 这 种 方法 的 方式 与 你 使 用 经 典 的 Response.Redirect 方法 相 
同 ， 区 别 是 现在 调用 程序 会 收 到 一 个 HITP 301 状态 码 。 这 对 于 浏览 器 的 影响 不 大 ， 但 对 于 
搜索 引擎 来 说 却 是 一 个 主要 区 别 。 

在 ASPNET MVC 中 ， 人 情况 要 容易 得 多 ， 因 为 RedirectResult 类 型 中 添加 了 新 的 名 为 
Permanent 的 Boolean 成 员 。 上 所 有 这 些 内 容 都 封装 在 你 很 可 能 会 使 用 的 Controller 类 的 
RedirectPermanent 方法 中 。 

public ActionResult Index() 

{ 


return RedirectPermanent (url).:; 


} 
如 前 所 述 ， 你 会 在 第 8 章 了 解 到 更 多 有 关 操 作 结 果 的 高 级 自 定义 的 话题 。 
2. 制定 路 由 和 URL 


ASPNET Web Forms 与 ASPNET MVC 之 间 的 巨大 差异 在 ASPNETMVC 中 ，URL 看 起 
来 更 像 是 你 发 送 给 Web 应 用 程序 的 命令 ， 而 非 到 页 面 和 资源 的 服务 器 路 径 。 因 为 路 由 机 制 
是 在 开发 人 员 的 全 面 控 制 之 下 ， 所 以 你 要 负责 为 你 的 应 用 程序 正确 制定 URL。 

如 果 认 真 思考 SEO， 就 会 明白 正确 制定 URL 主要 是 指 确保 URL 的 唯一 性 。 搜 索引 警 的 
主要 目的 之 一 是 确定 给 定 URL 实际 指 同 的 内 容 的 相关 程度 。 当 然 ， 如 果 只 能 在 一 个 地 方 并 
且 通 过 唯一 的 URL 找到 一 段 给 定 的 信息 ， 那 么 该 信息 就 具有 更 多 的 相关 性 。 然 而 ， 有 时 候 
即便 内 容 是 唯一 的 ， 它 也 可 以 通过 多 个 些许 不 同 的 URL 找到 。 在 这 种 情况 下 ， 你 的 风险 是 从 
搜索 引擎 获得 的 排名 较 低 ， 更 糟 的 是 ， 对 你 网 站 该 部 分 的 引用 会 落 在 最 后 的 结果 页 面 ， 很 难 
被 潜在 的 访问 者 注意 到 。 这 里 的 问题 与 存储 器 和 页 面 内 容 没 多 少 关 系 , 但 与 URL 的 格式 有 关 
系 。 即 使 万 维 网 联盟 (World Wide Web Consortium，W3C) 建 议 你 使 用 区 分 大 小 写 的 URL， 但 
是 从 SEO 角度 来 看 ， 使 用 单一 大 小 写 表 示 ( 且 为 小 写 ) 的 URL 是 更 好 的 选择 。 如 果 能 保持 所 
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有 的 URL 都 为 小 号， 那么 不 仅 能 减少 重复 的 URL， 还 会 加 强 网 站 的 一 致 性 。 


注意 : 

与 Unix 系统 不 同 ,请 求 URL 时 ASPNET 和 互联 网 信息 服务 (Internet Information Services， 
IIS) 不 区 分 大 小 写 。 大 概 是 出 于 从 W3C 的 角度 考虑 以 及 Unix 的 实践 ， 搜 索引 擎 将 区 分 大 小 
写 的 策略 应 用 到 了 URL 中 。 最 近 ， 大 多 数 搜索 引 敬 (主要 是 谷歌 ) 都 添加 了 各 种 形式 的 缓解 指 
施 ， 最 终 试图 将 这 些 区 分 大 小 写 的 URL 也 加 入 URL 排名 。 无 论 如 何 ， 如 果 网 站 公开 拼写 不 
同 的 终结 点 ， 最 终 的 排名 绝对 不 只 是 各 个 不 同 排 名 的 加 总 。 所 以 ， 需 要 指出 的 底线 就 是 ， 不 
注意 使 用 单一 大 小 写 表 示 的 URL 在 SEO 排名 中 会 相对 靠 后 。 


那么 外 部 链接 呢 ? 

对 于 避免 外 部 网 站 使 用 它们 中 意 的 大 写 或 小 写 链 接 到 你 网 站 的 页 面 ， 你 可 能 无 能 为 力 。 
最 有 可 能 的 情况 是 ， 他 们 直接 复制 你 的 URL， 由 此 重复 你 选择 的 大 小 写 。 如 果 不 是 你 所 选 的 
大 小 写 ， 你 随时 可 以 通过 一 个 拦截 BeginRequest 事件 的 HTTP 模块 进行 永久 重 定 同 。 强 制 
所 有 外 部 链接 使 用 相同 的 大 小 写 , 会 使 你 避免 在 多 个 URL 间 分 化 流量 , 以 便 将 所 有 的 流量 专 
注 于 单个 URL 从 而 获取 更 高 的 排名 (相对 于 其 他 软件 方案 中 流行 的 “分 而 治之 ”的 策略 ， 我 
们 称 这 种 策略 为 “ 合 而 治之 ”)。 

为 了 解决 这 一 问题 ， 还 定义 了 标准 的 URL 格式 。 标 准 的 URL 会 以 你 心目 中 首选 URL 
结构 的 形式 来 描述 你 所 认为 的 URL。 只 需要 在 <head> 部 分 添加 一 个 <link> 标 记 ， 如 下 所 示 : 


<link rel="canonical™" href="http://myserver.com/™" /> 


如 果 网 站 有 大 量 的 可 以 通过 多 个 URL 访问 的 内 容 ， 标 准 的 URL 就 能 为 搜索 引擎 提供 更 
多 的 信息 ， 这 样 一 来 搜索 引擎 就 可 以 将 相似 的 URL 作为 同一 个 URL 对 待 ， 由 此 产生 对 资源 
内 容 的 更 恰当 的 排名 。 标 准 URL 特征 (对 于 你 来 说 是 零 成 本 的 ) 的 可 能 影响 是 它 可 以 肃清 有 没 
有 尾部 斜 杠 的 争论 。 标准 的 URL 无 论 默认 为 哪 种 选择 , 对 于 搜索 引擎 来 说 实际 的 链接 都 没有 
区 别 。 


3. 尾部 斜 杠 


有 一 些 与 尾部 和 斜 杜 有 关 的 SEO 问题 。 特别 是 在 搜索 引擎 集成 了 一 个 第 选 右 , 检测 并 惩 避 
性 处 理 搜索 结果 中 重复 内 容 的 情况 下 。 重 复 的 内 容 是 指 在 搜索 结果 中 被 认为 是 与 其 他 页 面 一 
样 服 务 相 同 内 容 的 页 面 (也 就 是 说 ， 任 何不 同 的 URL)。 从 搜索 引擎 的 角度 看 ， 珊 有 尾部 和 斜 杠 
的 URL 和 不 市 尾部 和 斜 杜 的 URL 是 提供 相同 内 容 的 两 个 URL。 

要 尽 可 能 为 用 户 提供 最 相关 的 内 容 ， 搜 索引 擎 会 答 试 将 看 起 来 差不多 一 样 的 页 面 排名 降 
低 。 但 是 ， 这 一 过 程 可 能 会 无 意 中 降 低 好 网 页 的 排名 。 

那么 ASPNET MVC 和 路 由 系统 呢 ? 应 该 强制 有 尾部 斜 杜 吗 ? 
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最 终 ，ASPNET MVC 应 用 程序 会 完全 负责 其 URL 以 及 稍 后 的 搜索 引擎 之 请 求 。 在 一 个 

新 的 应 用 程序 中 ， 这 最 终 是 由 你 决定 的 ， 因 为 你 的 路 由 决定 了 如 何 处 理 请 求 。 用 于 在 标记 中 
生成 URL 的 帮助 器 往往 会 避免 尾部 和 斜 杠 , 所 以 我 们 说 没有 尾部 斜 杜 是 ASPNET MVC 中 更 为 
常见 的 解决 方案 。 但 是 ， 请 记 住 带 有 尾部 斜 杠 的 方法 一 样 有 效 。 在 ASPNET MVC 中 ， 用 同 
样 的 方式 解析 (或 不 解析 ) 带 有 和 不 带 有 尾部 斜 杠 的 URL 也 取决 于 你 。 你 最 终 决 定 了 你 的 网 页 
排名 。 是 否 使 用 尾部 斜 杠 并 不 像 要 符合 你 的 选择 那样 重要 。 

如 果 要 把 现 有 网 站 移植 到 ASPNET MVC， 可 能 会 有 很 多 遗留 的 URL 要 维护 。 可 以 安装 
一 个 自 定义 路 由 处理 程 序 ， 将 旧 的 URL 永久 重 定 同 (HTTP 301) 到 新 的 URL。 这 种 方法 很 有 
效 , 但 在 实践 中 搜索 引擎 需要 几 周 的 时 间 物 理 更 新 链接 的 内 部 表 , 以 反映 所 有 的 永久 重 定 回 。 
在 此 期 间 ， 你 或 许 会 失去 一 些 收益 。 

搜索 引擎 总 是 喜欢 处 理 现 有 的 URL。 在 这 种 情况 下 ， 你 需要 在 微软 IS 中 安装 一 个 重 写 
模块 ， 以 将 ASPNET MVC URL 映射 到 旧 的 URL。 


注意 : 

说 到 SEO, 还 有 一 点 需要 说 明 , 这 就 是 子 域 , 虽然 这 与 页 面 或 控制 器 操作 并 不 严格 相关 。 
一 般 情况 下 ， 在 网 站 的 设置 中 有 很 多 理由 要 考虑 子 域 。 第 见 的 原因 是 将 域 拆 分 为 子 域 ， 以 便 
通过 语言 、 产 吕 或 功能 对 网 站 进行 区 分 ,使 得 管理 更 为 容 奴 。 但 是 ， 搜 索引 萄 会 把 子 域 (包括 
裸 域 ， 比 如 myserver.com) 看 作 单 独 的 网 站 。 


5.1.2 ”管理 会 话 状 态 


任何 形态 和 形式 的 实际 应 用 程序 都 需要 维护 自己 的 状态 以 服务 用 户 请 求 。Web 应 用 程序 
也 不 例外 。 然 而 ， 不 同 于 其 他 类 型 的 应 用 程序 ，Web 应 用 程序 需要 特殊 的 系统 级 工具 才 能 元 
成 相同 任务 。 这 种 特殊 性 的 原因 在 于 ，Web 应 用 程序 仍然 依赖 感 层 协议 的 无 状态 特性 。 只 要 
HTTP Pee Web 的 传输 协议 ， 所 有 的 应 用 程序 便 会 遇 到 同样 的 及 烦 : 找 出 最 有 效 的 方法 来 

在 ASPNET 中 , HttpSessionState 类 提供 了 基于 字典 的 存储 和 检索 会 话 状态 值 的 模型 。 这 
个 类 不 会 在 特定 时 间 同 操作 应 用 程序 的 所 有 用 户 公开 它 的 内 容 。 只 有 发 端 于 同一 会 话 上 下 文 
的 请 求 一 即 通过 由 同一 浏览 右 实 例 所 产生 的 多 个 页 面 请 求 而 生成 的 可 以 访问 会 证 状 
态 。 会 话 状态 能 以 多 种 方式 存储 和 发 布 ， 包 括 在 Web 服务 器 场 或 Web 园 场景 中 。 不 过 ， 默 
认 会 在 ASPNET 工作 进程 中 保持 会 话 状 态 。 


1. 使 用 Session 对 象 


作为 ASPNETMVC 开发 人 员 ， 你 在 通 问 内 部 Session 对 象 的 路 上 并 没有 技术 上 的 局 限 。 
你 与 ASPNET Web Forms 应 用 程序 的 开发 人 员 有 着 差不多 相同 的 利 萄 。ASPNET MVC 基础 
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架构 在 内 部 使 用 会 话 状 态 ， 也 可 以 在 你 的 代码 中 这 样 做 。 特 别 是 ，ASPNET MVC 基础 架构 
会 使 用 会 话 状态 来 保持 TempData 字典 的 内 容 ， 正 如 第 4 章 “ 输 入 表单 ”中 所 述 。 

所 以 ， 如 果 和 觉得 有 必要 路 会 话 存储 数据 ， 则 先 将 其 存储 ， 然 后 通过 熟悉 的 Session 对 象 
将 其 读 取 回来 ， 如 下 所 示 : 

Public ActionResult Config'() 


{ 


Sesslon[StateEntries.PreferredTextColor] = "Green"™; 


} 


可 以 看 出 , 一 切 与 经 典 的 ASPNET 编程 没什么 两 样 。 但 是 要 记 住 ， 会话 字 典 是 一 个 名 称 
/ 值 集合 ， 因 此 它 需 要 普通 的 字符 串 来 标识 条 目 。 在 代码 中 使 用 常量 是 防止 发 生 致命 错误 的 好 
方法 。 当 你 读 取 会 话 状 态 时 ， 转 换 和 null 检查 是 不 可 避免 的 ， 如 下 所 示 : 

Var preferredTextColor = ™"} 

Var data = Sesslon[stateEntries.PreferredTextColor]; 


1f (data ! null) 
preferredTextColor = (String) data; 


在 会 话 状 态 中 存储 的 任何 数据 都 会 作为 一 个 Object 返回 。 
2. 绝 不 离开 控制 器 


涉及 访问 ASPNET MVC 中 会 话 状态 的 最 重要 一 点 是 ， 只 从 控制 器 内 部 使 用 它 。 一 般 来 
说 , 在 会 话 状态 中 存储 的 数据 可 以 有 两 种 使 用 方式 .。 可 以 用 来 驱动 一 些 输 入 数据 的 后 端 计算 ， 
也 可 以 原样 传递 给 视图 。 

在 第 二 种 情况 下 ， 确 保 你 将 单个 值 复制 到 视图 模型 类 上 的 适当 成 员 ， 或 复制 到 任意 一 个 
你 使 用 的 预定 义 视 图 数据 结构 (ViewData 或 ViewBag)。 从 理论 上 说 , 也 可 以 从 Razor 或 ASPX 
视图 中 访问 会 话 状 态 (及 其 他 内 部 对 象 )。 虽 然 所 有 像 这 样 的 代码 都 能 运行 ， 但 你 应 该 避免 这 
样 做 ， 以 保持 控制 器 和 视图 之 间 较 强 的 天 注 点 分 离 (Separation of Concerns，SoC)。 黄 金 法 则 
是 ， 视 图 从 外 部 接收 它 需 要 集成 的 任何 数据 。 


注意 : 

上 述 金 科 玉 律 对 于 呈现 操作 也 同样 适用 ， 这 些 呈 现 操作 就 是 你 直接 从 视图 调用 的 专门 控 
制 器 方法 。 哇 现 操 作 会 在 你 的 视图 中 添加 一 点 逻辑 ， 但 不 破坏 控制 器 和 视图 之 间 的 分 离 一 一 
视图 在 控制 器 中 将 继续 保持 其 唯一 的 联系 ， 
5.1.3 缓存 数据 

绥 存 表明 了 应 用 程序 将 频繁 使 用 的 数据 存储 到 中 间 存 储 介 质 的 能 力 。 在 标准 的 Web 场景 


第 5 章 ASPNET MVC 应 用 程序 的 特性 


中 ， 典 型 的 中 间 存 储 介 质 是 Web 服务 器 的 内 存 。 但 是 ， 可 以 围绕 每 个 应 用 程序 的 需求 和 特点 
来 设计 缓存， 因此 可 以 根据 需要 ， 使 用 任意 层 数 的 缓存 达到 你 的 性 能 目标 。 

在 ASPNET 中 ， 内 置 的 缓存 功能 是 通过 Cache 对 象 实现 的 。Cache 对 象 是 在 每 一 个 
AppDomain 基础 上 创建 的 ， 并 且 在 AppDomain 运行 期 间 它 仍然 保持 有 有效。 该 对 象 目 动 清除 
内 存 和 去 除 无 用 项 的 能 力 是 其 独 有 的 。 可 以 优先 处 理 并 将 缓存 项 关联 到 各 种 类 型 的 依赖 项 ， 
比如 磁盘 文件 、 其 他 缓存 项 以 及 数据 库 表 。 当 其 中 的 任 一 项 发 生 更 改 时 ， 缓 存 的 项 会 自动 失 
效 并 删除 。 此 外 ，Cache 对 象 提供 了 与 Session 一 样 常见 的 基于 字典 的 编程 接口 。 但 与 Session 
不 同 的 是 ，Cache 对 象 不 会 在 每 个 用 户 的 基础 上 存储 数据 。 


1. 本 地 Cache 对 象 的 优 劣 


在 ASPNET MVC 中 使 用 Cache 对 象 与 在 ASPNET Web Forms 中 使 用 是 一 样 的 。 从 控制 
器 类 或 基础 架构 类 ， 如 global.asax 中 ， 访 问 Cache 对 象 是 比较 合适 的 ， 如 下 所 示 : 

protected vold Application Start () 

{ 


Var data = LoadFromSomeRepository(); 
Cache [CacheEntries.CustomerRecords] = data; 


} 

要 读 取 绥 存 ， 可 以 使 用 刚刚 看 到 的 用 于 会 话 状 态 的 相同 模式 ， 检 查 nullness， 并 转换 成 
一 个 已 知 的 有 效 类 型 ， 如 下 所 示 : 

var customerRecords = new CustomerRecords ();}; 

Var data = Cache[CacheEntries.CustomerRecords];} 


1f (data ! null) 
customerRecords = (CustomerRecords) data; 


如 果 绥 存 的 数据 需要 在 视图 中 显示 ， 只 需要 将 数据 添加 到 特定 视图 的 视图 模型 类 即 可 。 
或 者， 可 以 在 控制 故 关 上 定义 呈现 操作 。 

目前 为 止 ， 一 切 都 是 正常 的 。 那 么 在 ASPNET MVC 中 缓存 的 劣势 是 什么 呢 ? 

如 前 所 述 ，Cache 对 象 受 限 于 当前 的 AppDomain 和 随后 的 当前 进程 。 这 种 设计 在 十 年 前 
还 是 不 错 的 ， 但 如 今 显 示 出 了 越 来 越 多 的 局 限 性 。 如 果 要 寻找 一 个 类 似 于 Session 的 全 局 存 
储 库 对 象 ， 跨 Web 服务 器 场 或 Web 园 染 构 工作 ， 那 么 本 地 Cache 对 象 是 不 适合 的 。 你 必须 
借助 Windows Server AppFabric Caching 服务 ， 或 是 一 些 商 业 框 架 (如 ScaleOut 或 NCache) 或 
者 开源 框架 (比如 Memcached)。 

然而 ， 问 题 是 Cache 对 象 的 实现 并 不 基于 与 会 话 状态 一 样 通用 的 提供 程序 模型 。 这 意味 
者 你 需要 将 其 扩展 时 ， 不 能 奉 换 缓存 数据 的 持 有 者 ， 即 使 是 测试 控制 秦 时 也 不 行 。 
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2. 注入 缓存 服务 


目前 在 ASPNET MVC 中 推荐 使 用 的 缓存 方法 包括 在 应 用 程序 中 注入 绥 存 功能 。 定 
个 抽象 缓存 服务 的 协议 ， 并 让 你 的 控制 器 根据 此 协议 工作 。 Apher 
可 以 通过 你 喜欢 的 控制 反 转 (IoC) 框 架 ， 也 可 以 通过 一 个 特 设 的 控制 器 构造 函数 的 方式 。 后 者 
被 戏称 为 “穷人 的 依赖 性 注入 方法 ”。 
下 面 的 代码 显示 了 如 何 抽象 缓存 层 的 一 个 小 而 实用 的 示例 : 
public interface ICacheService 
{ 
Object Get (String key); 
Vold Set (String key, Object datal) ; 
Object this[string key] { get; set; } 


} 


可 以 按照 需求 将 该 接口 制作 得 丰富 而 巧妙 。 例 如 ， 你 可 能 要 添加 成 员 以 支持 依赖 项 、 过 
期 事项 和 优先 事项 . 请 记 住 你 不 是 在 编写 用 于 整个 ASPNET 子 系统 的 缓存 层 ; 而 是 在 编写 你 
的 应 用 程序 中 的 某 一 段 代 码 。 在 这 方面 ，YAGNI 原则 (你 不 需要 它 ) 比 以 往 任何 时 候 都 有 用 。 

任何 需要 绥 存 的 控制 右 类 都 将 通过 构造 函数 接受 一 个 ICacheService 对 象 ， 如 下 所 示 : 


private ICacheService CcacheService; 
public HomeController (ICacheService cacheService) 
{ 

cachesService = cacheService; 


} 


接 下 来 需要 定义 ICacheService 接口 的 几 个 有 具体 实现 。 有 具体 类 型 会 直接 使 用 一 种 特定 的 组 


存 技术 来 存储 和 检索 数据 。 下 面 是 通过 使 用 本 地 ASPNET Cache 对 象 实 现 该 接口 的 一 个 类 的 


public class AspNetCacheService 
{ 
private readonly Cache aspnetCache; 
public AspNetCacheservice() 
{ 


: ICacheService 


1f (HttpContext.Current != null]l) 


aspnetCcache = HttpContext.Current -CacChe， 
} 


Public Object Get (string key) 
{ 
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return aspnetCache [keyl]; 


} 


public vold Set (String key, Object data) 
{ 

aspnetCache[key] = data; 
} 


public object this[String namel] 

{ 
get { return aspnetCache [name|; } 
set { aspnetcache [name]j = value; } 


} 
最 后 ， 让 我 们 完成 使 用 此 缓存 服务 的 控制 妖 人 代码， 以 便 能 正确 地 注入 该 服务 : 
public class HomeController 
{ 
private readonly ICacheservice CcacheService; 
public HomeController() : this (new AspNetCacheService()) 


{ 
} 
public HomeController (ICacheService cachesService) 
{ 
CacheService = cacheService; 
} 


} 

这 样 ， 需 要 缓存 的 控制 器 类 就 不 会 紧 紧 地 绑 定 到 菜 缓存 对 象 的 特定 实现 ， 而 且 最 起 码 更 
易于 测试 。 

3. 注入 缓存 服务 的 一 个 更 好 方式 

往 控制 需 实 例 中 注入 一 个 缓存 服务 要 求 必 须 为 每 个 请 求 创建 一 个 新 的 缓存 服务 。 由 于 组 
存 服 务 是 围绕 现 有 及 外 部 缓存 数据 持 有 者 (比如 ASPNETCache 对 象 或 Windows Server 
AppFabric Caching Services) 的 普通 封装 ， 因 此 不 会 对 请 求 的 性 能 有 多 大 影响 。 事 实 上 ， 缓 存 
数据 持 有 者 只 会 在 应 用 程序 局 动 时 初始 化 一 次 。 

你 能 设法 为 应 用 程序 的 每 个 请 求 节省 几 个 CPU 周期 并 公开 一 个 反 过 来 基于 可 更 换 提供 
程序 的 全 局 缓存 对 象 吗 ? 当 然 可 以 。 请 笠 试 将 下 面 的 代码 添加 a 到 global.asax 中 : 


public class MvcApplication : HttpApplication 
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// Internal reference to the cache wrapper object 
private static ICacheService “InternalCacheobject:; 


// Public method used to inject a new caching service into the application. 
// This method 1s required to ensure full testability. 

public vold ReglisterCacheService (ICacheService cacheSsService) 

{ 


“internalCacheObject = cacheSsService; 


// Use this property to access the underlying cache object from within 
// controller methods. Use this instead of native Cache object. 
public static ICacheService CachesService 


{ 


get { return internalCacheObject; } 


protected vold Application Start () 
{ 


// linject a global caching service 
ReglisterCacheService (new AspNetCachesService (1) ) ; 


// Store some sample app-wide data 
CacheService["StartTime"] = DateTime .Now; 


} 


这 样 ， 就 不 必 在 选 定 的 控制 器 中 为 每 个 请 求 注入 实际 的 缓存 服务 。 绥 存 服务 会 在 应 用 程 
序 启动 时 一 次 性 初始 化 并 且 注 入 。 控 制 器 使 用 应 用 程序 对 象 上 的 公共 静态 方法 (如 在 
global.asax 中 定义 的 ) 来 访问 缓存 。 


Var data = MvcApplication.CacheService[...] 


RegisterCacheService 公共 方法 保留 了 可 测试 性 。 在 任何 你 想 要 测试 某 个 缓存 识别 控制 器 
的 单元 测试 中 ， 都 可 以 在 单元 测试 的 初步 阶段 放置 下 面 的 调用 : 


MvcApplication.RegisterCacheService (new EakeCacheSerVlce () ) :; 


接着 继续 调用 该 控制 器 方法 ， 它 将 显 式 使 用 该 FakeCacheService。 
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4. 分 布 式 缓存 


通过 为 缓存 相关 的 任务 使 用 公共 协议 ， 使 其 更 易于 测试 ， 这 并 非 你 获得 的 唯一 好 处 : 通 
过 让 你 的 控制 器 随时 识别 缓存 接口 一 一 并 非 缓存 实现 一 一 它们 便 能 够 使 用 任何 通过 指定 接口 
提供 缓存 服务 的 对 象 。 换 句 话说 ， 可 以 将 上 述 的 AspNetCacheService 类 蔡 换 为 另 一 个 依赖 
人 不同 缓 存 染 构 的 外 形 类 似 的 类 。 

举例 来 说 ， 可 以 依据 分 布 式 的 架构 ， 例 如 Windows Server AppFabric Caching Services， 
或 者 另 一 个 开源 的 或 商业 的 框架 ， 显 式 插入 一 个 缓存 服务 。 差 不 多 所 有 这 些 框架 都 会 公开 一 
个 公共 API， 它 类 似 于 基本 的 ASPNET Cache 对 象 ， 因 此 不 需要 你 做 很 多 超出 配置 的 设置 
工作 。 

这 样 很 不 错 , 但 是 如 果 对 分 布 式 缓 存 不 感 兴趣 , 也 可 以 将 ASPNET 本 地 Cache 对 象 蔡 换 
成 最 新 的 在 NET Framework 4 中 引入 的 MemoryCache 对 象 , 它 的 明确 目的 就 是 为 所 有 的 NET 
应 用 程序 所 供 缓 存 功能 。 为 此 ， 访 类 是 在 ASPNET 范围 之 外 一 个 全 名 为 
System.Runtime.Caching 的 全 新 程序 集中 定义 的 。 MemoryCache 对 象 类 似 于 ASPNET Cache， 
不 同 之 处 在 于 如 宁 符 试 存 储 null 全 , 它 会 引发 异 弟 .MemoryCache 关 继 承 目 基 类 ObjectCache。 
通过 派生 你 目 己 的 缓存 对 象 ， 可 以 控制 内 部 存储 以 及 缓存 数据 的 管理 。 这 并 不 是 给 大 家 的 推 
荐 方法 , 但 它 绝 对 是 可 以 实现 的 。 但是， 请 记 住 ，ObjectCache 及 其 派生 的 类 型 并 不 适用 于 提 
供 分 布 式 缓存 功能 。 如 果 想 创建 自己 的 分 布 式 缓存 ， 可 能 会 面临 在 同步 过 程 中 维护 多 个 缓存 
的 抹 烦 。 


5. 缓存 方法 啊 应 


经 典 的 ASPNET 输出 缓存 机 制 在 ASPNET MVC 中 同样 适用 。 它 采用 OutputCache 特性 
的 形式 ， 可 以 将 其 附加 到 控制 器 方法 或 控制 器 类 ， 从 而 影响 所 有 的 操作 方法 。 


[OutputCache (Duration=10, VaryByParam-="None")] 


Public ActionResult Index() 
{ 


} 


Duration 参数 表示 方法 的 啊 应 应 该 在 内 存 中 保持 缓存 的 时 间 ( 以 秒 为 单位 )。 男 一 方面 ， 
VaryByParam 特性 表示 你 应 该 缓存 多 少 个 不 同 版 本 的 啊 应 ， 每 一 个 版 本 对 应 于 指定 属性 的 一 
个 不 同 值 。 如 果 使 用 None， 就 是 告知 系统 你 不 希望 同一 个 方法 有 多 个 版 本 的 啊 应 。 

表 5-1 列 出 了 该 特性 支持 的 属性 。 它 们 是 ASPNET 的 @OutputCache 指令 特性 的 一 个 子 
集 。 未 提 及 的 特性 是 局 限于 ASPNET 用 户 控 件 的 那些 特性 。 
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表 5-1 OutputCache 特性 的 属性 


CacheProfile 将 啊 应 与 web.config 文件 中 指定 的 一 组 输出 缓存 设置 天 联 起 来 

Duration 吧 应 缓存 的 时 长 (以 秒 计 ) 

Location 指定 存储 方法 调用 啊 应 的 位 置 (浏览 器 、 代 理 或 服务 上 器 )。 访 特性 的 值 是 从 
OutputCacheLocation 枚 举 中 获取 的 

NoStore 表示 是 否 友 运 一 个 Cache-Control:no-store 标 尖 来 阻止 浏 贤 器 病 的 啊 应 存储 

SqlDependency 表示 人 微软 SQL Server 数据 库 上 指定 表 的 一 个 依赖 项 。 在 表 内 容 变更 时 ， 啊 应 
会 从 缓存 中 移 除 

VaryByContentEncoding 你 要 用 于 区 分 绥 存 啊 应 的 内 容 编 但 

VaryByCustom 一 个 用 分 号 分 隅 的 字符 串 列 表 , 通过 广 列 表 可 以 基于 浏览 雁 关 型 或 用 户 定 义 的 
字符 串 来 维持 不 同 的 啊 应 缓存 副本 

VaryByHeader 用 分 气 分 陋 的 HITP 标 头 列表 

VaryByParam 一 个 用 分 号 分 隔 的 字符 串 列 表 ， 访 列表 表示 的 是 用 GET 方法 特性 友 送 的 食 询 


字符 串 的 值 ， 或 者 用 POST 方法 发 送 的 参数 


这 些 属 性 传递 的 是 相同 的 ASPNET 运行 时 的 输出 缓存 的 基础 架构 ， 与 在 ASPNET Web 
Forms 中 的 运行 情况 完全 一 梓 。 

注意 : 

这 应 该 是 显 而 荔 见 的 ， 但 让 我 们 说 得 更 清楚 一 些 吧 。 你 设置 OutputCache 特性 的 方法 在 
提供 了 有 效 的 缓存 响应 时 ， 不 会 为 响应 到 达 服 务 器 的 请 求 而 执行 。 

6. 局 部 输出 缓存 

局 部 缓存 并 不 局 限于 方法 的 整体 响应 。 你 还 可 以 将 Output Cache 特性 附加 到 子 操作 。 子 
操作 是 控制 器 上 的 一 个 方法 ， 视 图 可 以 通过 使 用 Html.RenderAction 帮助 右 回 调 它 。 
RenderAction 帮助 器 可 以 调用 控制 右上 的 任何 方法 ;但 某 些 方法 可 以 标记 为 独占 的 子 操作 。 
通过 使 用 如 下 所 示 的 ChildActionOnly 特性 来 实现 这 一 点 : 

[ChildActiononlyl] 


public ActionResult RendersiteMap () 
{ 


} 
这 种 方法 显然 用 于 呈现 视图 的 一 小 部 分 。 在 人 逻辑 上 等 同 于 ASPNET Web Forms 中 的 用 户 
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控件 。 通 过 使 用 OutputCache 特性 修饰 该 方法 ， 就 可 以 按照 指定 持续 时 间 缓存 响应 了 。 


5.2 ” 销 垢 处 理 


由 于 ASPNET MVC 是 在 经 典 的 ASPNET 运行 时 环境 之 上 运行 的 , 所 以 你 不 可 能 期 望 找 
到 一 个 完全 不 同 的 处 理 运行 时 错误 的 基础 架构 。 这 就 是 说 可 以 继续 选择 经 典 的 ASPNET 策 
上 略 , 将 任何 400 或 500 的 HTTP 状态 代码 映射 到 提供 错误 信息 的 特定 URL ,在 错误 需要 HTTP 
重 定 回 的 情况 下 以 编程 方式 切换 到 另 一 个 页 面 。 可 以 通过 web.config 文件 的 <customErrors> 
节 来 控制 映射 。 

依 我 之 见 ， 这 种 方法 虽然 可 用 ， 但 不 如 ASPNET MVC 中 的 方法 理想 ， 可 以 通过 直接 改 
变 由 控制 绒 调 用 的 视图 模板 的 名 称 ， 轻 松 地 切换 到 错误 界面 。 

让 我 们 看 看 当 ASPNET MVC 过 到 错误 处 理 的 时 候 所 要 提供 的 内 容 。 总 体 来 看 , ASPNET 
MVC 中 的 错误 处 理 跨越 了 两 个 主要 领域 ,程序 异常 和 路 由 异常 的 处 理 。 前 者 是 关于 在 控制 
秀和 视图 中 捕获 铬 误 的 ;而 后 痢 更 多 是 有 关 重 定 同 和 HITTP 钳 误 的 。 


5.2.1 处理 程序 异常 


你 在 ASPNET MVC 应 用 程序 中 编写 的 代码 大 部 分 留存 于 控制 器 类 中 。 在 控制 器 类 中 ， 
可 以 用 多 种 等 效 的 方式 处 理 可 能 的 异 毅 : 可 以 直接 通过 try/catch 块 、 通 过 重 写 OnException 
方法 、 也 可 以 使 用 HandleError 特性 来 处 理 异 常 。 


1. 直接 处 理 异 常 


首先 ， 可 以 使 用 本 地 的 try/catch 块 来 防止 代码 特定 部 分 的 可 能 异常 。 这 种 方式 为 你 所 
供 了 最 大 的 灵活 性 ， 但 代价 是 它 会 给 代码 市 来 些许 干扰 。 我 并 不 质疑 这 种 弄 第 处 理 的 重要 
性 一 一 顺便 说 一 句 ， 这 是 错误 处 理 的 官方 .NET 方法 一 一 但 是 try/catch 块 的 存在 会 使 代码 的 阅 
读 变 得 困难 。 出 于 这 个 原因 ， 我 总 是 会 欣然 接受 那些 将 异常 处 理 的 代码 集中 到 合理 范围 内 的 
普 代 解 次 方案 。 

要 执行 一 段 确 定 能 够 捕获 引起 任何 (或 只 是 一 些 ) 开 向 的 代码 ， 可 以 使 用 下 面 的 代码 : 

try 

{ 


// Your regular code here 


} 
catch 
{ 


// Your recovery code for all exceptions 
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} 


上 面 的 代码 段 会 捕获 由 try 块 中 的 代码 所 引起 的 各 种 异常 。 由 于 其 极 大 的 通用 性 ， 它 不 
会 将 你 置 于 实现 有 效 恢 复 策略 的 位 置 。 示 例 代 码 段 可 以 有 很 多 变化 和 扩展 。 例 如 ， 可 以 列 出 
多 个 catch 块 ， 每 个 显著 的 例外 对 应 一 个 。 你 还 可 以 添加 一 个 finally 块 ， 它 将 最 终 完 成 操作 
和 运行 ， 而 不 考虑 执行 汽 通 过 try 块 还 是 catch 块 : 

try 

{ 


// Your regular code here 


} 
catch (NullReferenceException nullReferenceExcept1ion) 
{ 


// Your recovery code for the null reference exception 


} 
catch (ArgumentException argumentExcept1on,) 
{ 


// Your recovery code for the argument except1ion 


} 
finally 
{ 


// Finalize here, but DON'T throw exceptions from here 


} 


从 最 具体 到 最 概略 的 异常 情况 都 列 示 出 来 了 。 从 catch 块 中 ， 你 还 可 以 处 理 异常 ， 以 便 
其 他 顶层 模块 不 会 获知 相关 情况 。 或 者 ， 可 以 妥善 地 处 理 这 种 情况 并 回收 。 最 后 ， 可 以 做 一 
些 工 作 ， 然 后 重新 抛 出 相同 的 异常 或 设置 一 个 新 的 异常 ， 其 中 人 带 有 一 些 额 外 的 或 修改 过 的 
信息 。 

涉及 编写 处 理 异 党 的 直接 代码 时 ， 你 还 需要 牢记 几 条 原则 。 首 先 ， 如 果 代 码 运 行 到 catch 
块 ， 其 代价 是 极其 高 昂 的 。 因 此 ， 你 应 该 明智 地 使 用 它 一 一 只 在 确实 需要 且 不 会 过 度 捕获 的 
时 候 使 用 。 


注意 : 

长 时 间 以 来 ,微软 都 建议 从 System.ApplicationException 派生 异 第 类 。 最 近 ， 这 一 观点 出 
现 了 彻底 的 转变 :新 的 指令 显示 出 相反 的 情况 .应 该 忽略 ApplicationException, 并 从 Exception 
或 其 他 更 特定 的 内 置 类 来 派生 你 的 异 第 类 。 同 时 ， 别 所 了 让 你 的 异 第 类 厅 列 化 。 更 多 的 背 闵 
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信息 ,请 参阅 StackOverflow 的 以 下 线程 (以 及 所 包含 的 链接 )http://stackoverflow.comy/questions/ 
5685923/what-1s-applicationexception-for-m-net. 


此 外 ， 一 定 不 要 引发 作为 根 System.Exception 类 实例 的 异常 。 强 烈 建 议 你 尝试 使 用 内 置 
的 异常 类 型 ， 如 InvalidOperationException、NullReferenceException 和 AreumentNullException 
等 ， 只 要 这 些 类 型 适用 。 你 应 该 避免 全 面 使 用 自己 定义 的 异常 ， 虽 然 对 于 程序 错误 ， 你 应 该 
考虑 定义 自己 的 异常 。 一 般 情 况 下 ， 应 当 将 异常 具体 化 。AreumentNullException 就 比 
ArgumentException 更 具体 。 异 疝 通 第 会 带 有 一 条 消息 ， 该 消息 必须 针对 开 肥 人员， 并 且 在 理 


想 情况 下 要 本 地 化 。 
注意 : 


来 自 微软 的 关于 异 第 处 理 的 另 一 项 主要 原则 是 ,对 于 一 般 的 错误 (比如 null 引用 、 无 效 的 
参数 、LO 或 网 络 异 常 ) 使 用 内 置 类 型 ， 对 于 特定 于 你 正在 创建 的 应 用 程序 ， 要 创建 应 用 程序 
专属 的 措 第 类 型 。 

2. 重 写 OnException 方法 

正如 第 1 章 “ASPNET MVC 控制 器 ”中 所 讨论 的 ， 各 个 控制 器 方法 的 执行 都 受到 一 个 
被 称 作 操作 调用 程序 的 特殊 系统 组 件 的 调控 。 关 于 默认 操作 调用 程序 有 意思 的 一 点 是 ， 它 会 
一 直 在 try/catch 块 中 执行 控制 器 方法 。 下 面 是 一 些 说 明 默 认 操 作 调 用 程序 行为 的 伪 代 码 : 

try 


{ 
// Try to invoke the action method 


} 
catch (ThreadAbortExcept1ion) 
{ 

throws; 
} 
catch (Exception except1ion) 
{ 


// Prepare the context for the current action 
Var filterContext = PrepareActionExecutedContext( ..., exception); 


// Go through the 11st of reglistered action filters, and give them a chance 
to recover 


// Re-throw if not completely handled 
1f (!'filterCcontext .ExceptionHandled) 
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throw: 


如 果 在 方法 的 执行 过 程 中 或 在 视图 的 呈现 过 程 中 的 茶 一 时 刻 引 友 了 一 个 异常 ， 该 控件 就 
会 运行 catch 块 中 的 代码 ， 只 机 该 异 第 不 是 ThreadAbortException。 处 理 异 各 需要 循环 所 历 已 
注册 的 操作 算 选 器 列表 ， 并 把 解决 问题 的 机 会 留 给 它们 目 己 。 在 循环 结束 时 ， 如 果 异 种 未 被 
标记 为 已 处 理 ， 则 捕获 到 的 异常 会 册 一 次 被 抛 出 。 

操作 筛选 句 是 一 段 代 码 ， 它 可 以 被 注册 用 来 处 理 一 些 在 操作 方法 执行 过 程 中 所 引发 的 事 
件 。 其 中 的 一 个 系统 事件 就 是 在 调用 程序 截获 到 异 音 的 时 候 触 发 (我 会 在 第 8 章 对 操作 筛选 需 
做 详细 讲解 )。 将 你 目 己 的 代码 添加 到 第 选 占 列表 的 最 简单 方法 是 香 写 控制 器 类 上 的 
OnException 方法 ， 如 下 所 示 : 


protected override Vold OnException (ExceptionContext filterContext) 


{ 
} 


该 方法 可 以 在 你 的 所 有 控制 器 类 (或 你 的 一 个 基 类 ) 中 定义 ， 且 第 第 在 操作 方法 发 生 未 处 
理 卉 沼 时 被 调用 。 


注意 : 
异常 是 不 会 由 源 于 控制 器 范围 之 外 的 OnException 捕获 的 ， 比 如 来 自 模 型 绑 定 层 失败 
中 的 null 引用 ， 或 从 无 效 路 由 中 所 产生 的 未 发 现 异 常 。 我 会 在 本 章 稍 后 详细 探讨 这 一 方面 的 


忆 体 来 看 ， 只 有 一 个 理由 重 写 控制 器 类 中 的 OnException， 即 你 希望 控制 系统 的 行为 以 
及 在 异常 情况 下 平稳 降级 运行 。 这 意味 着 OnException 中 的 代码 被 赋予 了 对 于 失败 请 求 的 整 
个 响应 的 控制 权 。 这 个 方法 会 接收 一 个 ExceptionContext 类 型 的 参数 。 该 类 型 带 有 一 个 
ActionResult 类 型 的 Result 属性 。 你 可 能 会 猜 到 ， 这 个 属性 指 的 是 下 一 个 视图 或 操作 结果 。 
如 果 OnException 中 的 代码 省 略 了 设置 结果 ， 那 么 用 户 就 不 会 看 到 任何 错误 界面 (不 论 是 系统 
的 还 是 应 用 程序 的 钳 误 界面 ); 用 户 只 会 看 到 ss 日 备 面 。 下 和 面 是 实现 OnException 的 典型 
pt 

protected override void OnException (ExceptionContext filterContext) 

{ 

// Let other exceptions Just go unhandled 


if (filterContext.Exception 1s InvalidoperationExcept1ion) 


{ 
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// Default view is "error™ 
filterContext .SwitchToErrorView (); 


} 
SwitchToErrorView 方法 是 用 于 ExceptionContext 类 的 扩展 方法 ， 其 编码 如 下 所 示 : 


public static voild SwitchToErrorView(this ExceptionContext context, 


String view = "error™", String master = "") 
{ 
Var controllerName = context.RouteData.Values["controller"] as String; 
Var actionName = context.RouteData.Values["action"] as String; 
Var model = new HandleErrorinfo (context.Exception, controllerName, 
actionName); 
Var result = new ViewResult 
{ 

ViewName = VlewWw, 

MasterName = master, 

ViewData = new 

ViewDataDictionary<HandleErrorIinfo> (model), 
TempData = context .Controller.TempData 
上 
context.Result = result.; 
// Configure the response ob]ect 
context .ExceptionHandled = true; 
context .HttpContext.Response.Clear (); 
context .HttpContext .Response.SstatusCode = 200; 
context .HttpContext .Response.TrySkipIlisCustomErrors = true; 
} 


总 的 来 说 ， 这 些 代 码 提 供 了 一 个 有 效 的 框架 级 try/catch 块 ， 它 不 仅 捕获 异常 ， 还 会 切换 
到 一 个 错误 视图 。 在 上 面 所 示 的 代码 中 ， 默 认 的 铬 误 视 图 是 error， 但 可 以 对 它 及 其 布局 进行 
更 改 。 

3. 使 用 HandleError 特性 

作为 重 写 OnException 方法 的 蔡 代 选项 , 可 以 用 HandleError 特性 以 及 由 它 派生 出 来 的 自 
定义 关 来 修饰 这 个 类 (或 个 别 的 方法 )。 


[HandleError | 
public class HomeController 
{ 
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} 


注意 ，HandleError 比 一 个 简单 特性 的 含义 要 多 一 些 ; 它 是 一 个 操作 筛选 器 。 就 其 本 身 而 
言 ， 它 包含 可 执行 代码 ， 而 且 并 不 局 限于 同 其 他 一 些 模块 提供 元 信息 。 尤 其 是 ，HandleError 
实现 了 正 xceptionFilter 接口 ， 如 下 所 示 : 

Public interface IExceptionFilter 

{ 

Vold OnException (ExceptionContext filterContext).; 

} 

该 接口 也 是 所 有 控制 器 实现 的 接口 。 但 是 ， 在 控制 器 的 基 类 上 ，OnException 只 有 一 个 
空 主体 。 

在 内 部 ，HandleError 通过 使 用 一 上 段 非常 类 似 于 SwitchToErrorView 的 代码 实现 了 
OnException 方法 。 唯 一 的 区 别 是 操作 视图 更 改 的 情形 。HandleError 特性 只 有 在 它们 没有 被 
提前 完全 处 理 有 旦 并 不 从 子 操作 中 产生 的 情况 下 ， 才 会 捕获 指定 的 异 弟 。 奎 要 控制 你 要 处 理 的 
异种 ， 请 这 循 下 面 的 做 法 : 


[HandleError (ExceptionType=typeof (NuL1LRefereTnceExcept1lon) ， 
View="SyntaxError")] 


每 个 方法 都 可 以 有 多 个 特性 匹配 项 ,每 一 个 匹配 项 对 应 一 个 相关 的 异常 。View 和 Master 
属性 表示 要 在 异常 后 显示 的 视图 。 默 认 情 况 下 ，HandleError 会 切换 到 名 为 error 的 视图 (这 样 
一 个 视图 是 由 微软 Visual Studio ASPNET MVC 标准 模板 特意 创建 的 )。 


重要 提示 : 

为 了 在 调试 模式 下 产生 HandleError 的 任何 可 见 结 果 ， 你 需要 打开 应 用 程序 级 别 的 自 定 
义 错 误 ， 如 下 所 示 : 

<CUStomErrors mode="On"> 

</customErrors> 

如 果 对 配置 文件 的 <ecustomEirors> 节 进行 了 默认 设置 ， 那 么 只 有 远程 用 己 会 得 到 所 选 的 
错误 页 面 。 本 地 用 户 ( 比 如 正在 进行 调试 的 开发 人 员 ) 将 收 到 经 典 的 错误 页 面 ， 其 中 市 有 由 首 
通 ASPNET 异常 处 理 程序 所 生成 的 有 关 堆 栈 跟踪 的 详细 信息 。 


小 贴 士 : 

即使 所 有 一 切 都 完全 配置 为 显示 自 定义 错误 页 面 ，Internet Explorer 显示 内 置 错误 页 面 的 
情况 也 可 能 发 生 。 这 归 因 于 自 2006 年 以 来 就 已 经 存在 的 一 个 不 为 人 知 的 Internet Explorer 功 
能 。 在 实际 情况 中 ， 如 果 Internet Explorer 检测 到 你 的 错误 页 面 有 不 大 于 512 个 字 节 的 正文 ， 
它 仅 仅 会 直接 显示 一 个 内 置 页 面 ， 因 为 或 者 它 相 信 一 一 这 让 用 户 看 到 会 更 好 ! 这 对 于 现 
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实 中 的 网 站 和 网 页 算 不 了 什么 ， 但 在 开发 的 初始 阶段 ， 它 却 很 容 荔 令 人 头疼 。 


就 像 ASPNET MVC 中 的 其 他 任何 操作 筛 选 器 一 样 ， 可 以 通过 将 HandleError 特性 注册 
为 全 局 过 滤器 ， 从 而 将 其 自动 应 用 到 任意 控制 器 类 的 方法 上 。 顺 便 说 一 句 ， 这 正 是 用 于 
ASPNET MVC 的 Visual Studio 模具 所 生成 的 代码 内 部 太 生 的 情况 。 下 面 是 来 自 global.asax 
中 的 Application Start 的 一 段 摘 录 : 
public class MvcApplication : System.Web.HttpApplication 
{ 
protected void Application Start () 


{ 
ReglisterGlobalFilters (GlobalFilters.Filters); 


} 


public static vold ReglisterGlobalFilters (GlobalFilterCollection filters) 
{ 
filters.Add (new HandleErrorAttribute()); 
} 
} 


全 局 短 选 毁 是 默认 的 操作 调用 程序 在 调用 操作 方法 之 前 自动 添加 到 算 选 器 列 表 中 的 一 
种 操作 筛选 器 。 我 还 会 在 第 8 章 中 对 全 局 操作 季 选 器 做 更 多 介绍 。 
5.2.2 全 局 销 误 处 理 

大 多 数 情况 下 ，OnException 和 HandleError 特性 会 提供 面向 错误 处 理 的 控制 器 级 别 的 控 
制 。 这 意味 着 ， 每 个 需要 错误 处 理 的 控制 器 必须 承载 一 些 异 第 处 理 代 码 。 但 更 重 要 的 是 ， 在 
控制 器 级 别处 理 错误 并 不 保证 能 够 拦截 围绕 你 应 用 程序 所 引发 的 所 有 可 能 异常 。 

可 以 创建 一 个 应 用 程序 级 别 的 错误 处 理 程序 ， 来 捕获 所 有 未 处 理 的 弄 常 ， 并 将 它们 路 由 
到 指定 的 错误 视图 。 

1. 来 目 global.asax 的 全 局 销 误 处 理 

从 ASPNET 运行 时 的 第 一 个 版 本 开始 ，HttpApplication 对 象 一 一 global.asax 背后 的 对 
象 一 一 就 以 Error 事件 为 特点 了。 每 当 未 处 理 的 寞 党 到 达 应 用 程序 中 代码 的 最 外 层 时 即 引 发 该 
事件 。 下 面 是 如 何 编写 这 样 一 个 处 理 程序 的 例子 : 


Vold Application Error(Object sender, EventArgs e) 


{ 


} 
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可 以 在 此 事件 处 理 程 序 中 做 一 些 有 用 的 事情 ， 例 如 加 网 站 管理 员 上 友 送 电子 邮件 ， 或 写 入 
微软 Windows 事件 日 志 以 记录 页 面 未 能 正确 执行 的 信息 。 下 面 是 一 个 示例 : 


Vold Application Error (Object sender, EventArgs e) 


{ 
var exception = SerVer .GetLastError () ; 
if (exception == null) 
return; 
Var malil = new MallMessage { From = new MalilAddress 
("automatedlcontoso.com™) }; 
malil.To.Add (new MalilAddress ("administrator@contoso.com"™)); 
mail.sSubject = "Site Error at "+ DateTime .Now; 
malil.Body = "Error Description: " + exception.Message; 
var server = new SmtpClient { Host = "your.smtp.server™ }; 
Server.Send (mal11) ; 
// Clear the error 
Server.ClearError(); 
// Redirect to a landing page 
Response.Redirect ("home/landing");} 
} 


有 了 前 面 的 代码 ， 管 理 员 就 会 收 到 一 封 电子 邮件 (如 图 5-1 所 示 )， 但 用 户 仍 然 会 收 到 一 
个 系统 错误 页 面 。 如 果 要 避免 这 种 情况 ， 可 以 在 你 处 理 错误 之 后 将 用 户 重 定向 到 一 个 着 陆 页 
面 。 最 后 要 明确 的 是 ， 如 果 SMTP 服务 器 裔 要 里 份 验证 ， 那 束 需 要 通过 SmtpClient 类 的 
Credentials 属性 提供 你 的 凭据 。 


盾 和 妆 好 |= >iteErorat 10/18/20B8:13:10. 一 回 昱 
Message 


ent: 10/8/2013 8:13 Ph 
administrator Bcontoso.com 


Subject Site Error at 10/8/2013 8:13 PM 


Error Description: This operation is not valid at this time. 


See more about automated@contoso,com 


图 5-1 发 送 给 网 站 管理 员 的 电子 邮件 
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2. 使 用 HTTP 模块 的 全 局 错误 处 理 


在 ASPNET 中 ， 捕 获 致命 的 异种 只 有 一 个 方法 : 即 编写 一 个 用 于 HttpApplication 对 象 
Error 事件 的 处 理 程序 。 但 有 两 种 实现 方式 。 可 以 直接 在 应 用 程序 的 global.asax 文件 中 编写 代 
码 ， 也 可 以 在 web.config 文件 中 插入 一 个 量 身 定做 的 HTTP 模块 。HTTP 模块 会 注册 自己 的 
用 于 Error 应 用 程序 事件 的 处 理 程序 。 这 两 种 解决 方案 在 功能 上 相同 ， 但 基于 HITP 模块 的 
解决 方案 可 以 在 无 有 顷 重 新 编译 应 用 程序 的 情况 下 打开 、 关 闭 以 及 修改 。 它 是 一 种 不 那么 烦人 
的 方式 。 

在 考虑 一 个 全 局 错误 处 理 程序 时 ， 你 需要 牢记 两 个 理念 : 同 管理 员 警 示 异 常 以 及 日 志 记 
录 寞 常 。 特 别 是 对 于 第 二 个 任务 ，HTTP 模块 似乎 是 比 globalasax 中 的 代码 更 容易 管理 的 解 
决 方案 。 

在 ASPNET 开 有 友人 员 之 间 比 较 流 行 的 工具 是 错误 日 志 记 录 模 块 和 处 理 程 序 (Error 
Logging Modules And Handlers，ELMAH)。ELMAH 本 质 上 是 由 一 个 HTTP 模块 构成 ， 一 旦 
配置 ， 就 会 拦截 应 用 程序 级 别 的 Error 事件 ， 并 根据 大 量 后 端 存 储 库 的 配置 将 其 记录 下 来 。 
ELMAH 源 自 一 个 开源 项 目 (http:Wcode.google.comypyelmahb) 以 及 大 量 的 扩展 , 这 些 扩展 主要 是 
在 存储 库 方 面 进行 的 。ELMAH 提供 了 一 些 很 好 的 设施 ， 比 如 可 以 在 上 面 租 看 所 有 记录 过 的 
异常 并 对 每 一 个 异常 进行 仔细 研究 的 网 页 。 从 体系 结构 上 来 说 , 任何 专属 于 ASPNET 的 错误 
报告 系统 都 与 ELMAH 区 别 不 大 。 


3. 拦截 模型 绑 定 的 异常 


集中 式 的 镜 误 处 理 程序 还 善于 捕获 源 自 控制 占 以 外 的 异常 ， 比 如 由 不 正确 的 参数 引起 的 
异 汕 。 如 果 声 明了 市 有 一 个 参数 的 控制 器 方法 ， 例 如 整数 参数 ， 而 当前 绑 定 器 不 能 匹配 任何 
提交 到 该 参数 的 值 ， 就 会 得 到 一 个 异 第 。 从 技术 上 讲 ， 该 异常 并 不 是 由 模型 绑 定 器 本 号 所 触 
发 ， 而 是 由 一 个 操作 调用 程序 的 内 部 组 件 在 准备 方法 调用 时 引发 的 。 如 果 该 组 件 找 不 到 用 于 
非 可 选 方法 参数 的 值 ， 它 就 会 抛 出 一 个 异常 。 

此 异常 个 会 从 控制 器 代码 的 内 部 抛 出 ， 但 它 依然 在 操作 调用 程序 中 处 于 整体 try/catch 块 
的 控制 之 下 。 全 局 (或 本 地 ) 的 HandleError 为 什么 不 进行 异 第 捕获 呢 ? 它 会 的 ， 但 只 有 在 你 打 
开 了 web.config 文件 中 的 自 定 义 错误 标志 时 才 会 。 当 目 定义 错误 标志 关闭 时 ， 拦 截 模型 绑 定 
错误 的 唯一 办 法 就 只 能 是 借助 于 global.asax 中 的 集中 式 错 误 处 理 程 序 。 5-2 显示 了 妥善 处 
理 后 提供 给 用 户 的 页 面 ， 以 及 发 送 给 管理 员 的 电子 邮件 消息 。 
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€ 乱 httpi/ /localhostl16219/hormeerror 
Bim x | 


Sorry, an error occurrerd 


sent 10/8/2013 B13 PM 


Subject: Site Error at 10/8/2013 B13 PM 


Error Description: The parameters dictionary contains a null entry for parameter 
‘someValue’" of non-nullable type 'Ssystem.Int32' for method 


‘System.Web.Mvc.ActionResult Binder(Int32)" in 
TryCatch.controllers.HomeController. An optional parameter must be a reference 
type, a nullable type, or be declared as an optional parameter. 

Parameter name: parameters 


See more about: automated@contoso.com 


图 5-2 ”由 Application Error 处 理 程序 捕获 的 模型 绑 定 器 异常 
4. 处 理 路 由 异 帝 


除了 检测 到 的 程序 错误 ,你 的 应 用 程序 还 可 能 因为 传 入 请 求 的 URL 不 匹配 任何 映射 的 路 
由 而 抛 出 异 第 一 一 无 论 是 由 于 无 效 的 URL 模式 (无 效 的 操作 或 控制 器 名 称 ) 还 是 违 反 了 约束 。 
在 这 种 情况 下 ， 你 的 用 户 会 收 到 一 个 HTTP 404 错误 。 你 可 能 有 多 种 原因 希望 能 避免 让 用 户 
接收 默认 的 404 ASPNET 页 面 ， 但 最 主要 的 是 为 了 向 最 终 用 户 提供 更 友好 的 页 面 。 

由 ASPNET 框 染 强制 执行 的 典型 解决 方案 包括 为 404 和 403 等 第 见 的 HTTP 代码 定义 的 
自 定义 页 面 (或 ASPNET MVC 中 的 路 由 )。 每 当 用 户 输入 或 打开 一 个 无 效 的 URL 时 ,他 就 会 
被 重 定 同 到 男 一 个 提供 了 一 些 有 用 信息 (希望 如 此 ) 的 页 面 。 以 下 是 如 何在 ASPNET MVC 中 
注册 特定 路 由 : 

<customErrors mode= On ”> 

<error statusCode="404™ redirect="/error/show" /> 


</customErrorsy> 


这 一 招 很 党 用 ， 从 纯粹 功能 的 角度 来 说 没有 什么 可 质疑 的 。 那 么 ， 问 题 到 辰 在 哪里 呢 ? 

第 一 个 问题 是 安全 性 。 通 过 将 HITP 错误 映射 到 个 性 化 的 视图 ， 黑 客 可 以 区 分 应 用 程序 中 
可 能 发 生 的 不 同类 型 的 错误 , 并 利用 这 些 信息 计划 进一步 的 攻击 。 因此 , 你 要 将 <customErrors> 
节 的 defaultRedirect 特性 设置 成 指定 并 且 固 定 的 URL， 并 确保 未 设置 各 状态 代码 。 

各 状态 代码 视图 的 第 二 个 问题 与 SEO 有 关 。 想象 一 下 , 一 个 搜索 引擎 在 一 个 实现 自 定 义 
错误 路 由 的 应 用 程序 中 请 求 一 个 并 不 存在 的 URL。 应 用 程序 首先 会 生成 一 个 HTTP 302 代码 ， 
并 通知 调用 方 资源 已 暂时 迁 至 另 一 个 位 置 。 这 时 ， 调 用 方 会 做 第 二 次 尝试 ， 并 终于 到 达 错 误 
页 面 。 这 种 方法 对 人 来 说 不 错 ， 能 最 终 得 到 一 条 深 腕 的 消 晨 ; 但 从 SEO 的 角度 来 看 算 不 上 最 
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优 ， 因 为 它 会 导致 搜索 引擎 断定 内 容 没 有 遗漏 ， 只 是 比 平 常 更 难 检索 而 已 。 并 且 ， 错 误 页 面 
会 作为 彰 规 内 容 编目 到 相关 类 似 的 内 容 。 

另 一 方面 ， 路 由 异常 是 一 种 特殊 类 型 的 错误 ， 并 且 值 得 区 别 于 程序 错误 的 特别 策略 。 基 
本 上 ， 路 由 开 第 都 涉及 一 些 缺 失 的 内 容 。 
5.2.3 ”处 理 缺 失 内 容 

路 由 子 系统 是 应 用 程序 的 前 端 ， 也 是 请 求 URL 获取 一 些 内 容 的 入 口 。 在 ASPNETMVC 
中 ， 以 与 处 理 有 效 请 求 相同 的 方式 处 理 缺失 内 容 的 请 求 很 简单 。 如 果 创建 一 个 捕获 将 不 被 处 
理 的 所 有 请 求 的 专用 控制 器 ， 就 不 需要 重 定向 和 额外 的 配置 。 


1. 全 部 捕获 (catch-all) 路 由 


处 理 这 种 情况 的 常见 做 法 是 在 global.asax 中 完成 路 由 集合 ,用 一 个 全 部 捕获 (catch-alD) 路 
由 捕获 发 送 到 你 的 应 用 程序 的 尚未 被 任何 现 有 路 由 所 捕获 的 URL。 


public static void RegisterRoutes (RouteCollection routes) 
{ 


// Maln routes 


// Catch-all route 
routes .MapRoutel 
"enalLl™ 
"{*anything}™, 
new { controller = "Error™", action = "Missing"™” } 
); 
} 
很 明显 ， 全 部 捕获 规则 需要 在 路 由 列表 的 最 展 部 运行 。 这 是 很 必要 的 ， 因 为 路 由 的 计算 
是 从 顶部 到 撒 部 ， 且 分 析 会 止 于 找到 第 一 个 匹配 项 的 时 候 。 全 部 捕获 路 由 会 将 请 求 映 射 到 你 
的 应 用 程序 专属 的 Error 控制 器 (在 ASPNET MVC 中 并 没有 现成 的 Error 控制 器 ,但 强烈 建议 
你 自己 创建 一 个 )。 反 过 来 ，Error 控制 器 着 眼 于 内 容 和 标 头 ， 并 随后 决定 要 返回 的 HITP 代 
码 。 下 面 是 这 种 Error 控制 器 的 一 个 示例 : 
public class ErrorController : Controller 
{ 
public ActionResult MIsslInd() 
{ 
HttpContext.Response.statusCode = 404; 
HttpContext .Response.TrySkipIisCustomErrors = true; 


173 


174 


第 中 部 分 ASPNET MVC 软件 设计 


// Log the error (if necessary) 


// Pass some optional information to the view 
Var model = ErrorViewModel () ; 
model .Message = ...} 


// Render the view 
return View (model).; 


} 

上 述 示例 中 的 ErrorViewModel 类 是 你 以 强 类 型 方式 用 于 将 数据 传递 到 基础 视图 的 任意 
视图 模型 类 。 使 用 ViewData 字典 也 可 以 ， 且 总 的 来 说 ViewData 字典 是 这 个 特定 且 相 对 简单 
的 上 下 文中 一 个 可 接受 的 折 中 方案 。 

通过 使 用 错误 控制 器 ， 可 以 提高 应 用 程序 的 友好 性 ， 并 为 搜索 引擎 对 其 进行 优化 。 实 际 
上 ， 在 将 直接 的 ( 即 非 重 定 同 ) 错 误 代 码 返 回 给 任意 调用 方 的 同时 ， 你 也 为 用 户 提 供 了 一 个 漂 
亮 的 用 户 界 面 。 


注意 : 

全 部 捕获 路 由 就 是 一 个 为 URL 选 出 的 不 匹配 任何 其 他 路 由 的 路 由 。 但 是 , 许多 路 由 是 通 
过 标准 路 由 来 匹配 的 ， 该 标准 路 由 总 体 来 说 是 一 个 相当 通用 的 几乎 全 部 捕获 (catch-almost-al) 
的 路 由 。 换言之 , 像 /foo 这 样 的 一 个 URL 会 匹配 默认 路 由 , 并 且 永 远 不 会 到 达 全 部 捕获 路 由 。 
因此 ， 如 果 它 缺少 一 个 Foo 控制 器 ， 就 会 导致 404 错误 。 为 了 拦截 因 无 效 控制 器 名 称 而 导致 
的 404 错误 ， 你 需要 重 写 控 制 器 工厂 (第 7 章 还 将 就 此 问题 讨论 更 多 细节 )。 


2. 跳 过 lS 错误 处 理 策略 


在 前 面 的 代码 片段 中 ，ErorController 类 上 的 Missing 方法 在 某 些 时 候 会 将 Response 对 
象 的 TrySkipIisCustomErrors 属性 设置 为 true。 它 是 在 ASPNET 3.5 中 引入 的 属性 ， 专门 处 理 
IIS 7 集成 管道 的 一 个 功能 。 

当 一 个 ASPNET 应 用 程序 (Web Forms 或 ASPNETMVOC) 在 HS7 下 的 集成 管道 内 运行 时 ， 
一 些 ASPNET 的 配置 设置 会 与 在 HS 级 别 定义 的 设置 合并 ， 如 图 5-3 所 示 。 

尤其 是 ， 如 果 在 IIS 中 定义 用 于 常见 HITP 状态 代码 的 错误 页 面 ， 默 认 情 况 下 这 些 页 面 
将 优先 于 由 ASPNET 生成 的 内 容 。 其 结果 是 , 你 的 应 用 程序 可 能 会 捕获 一 个 HTTP 404 错误 ， 
并 回 用 户 提 供 一 个 好 看 的 特 设 网 页 。 不 论 愿 意 与 否 ， 你 的 网 页 都 不 会 到 达 最 终 用 户 ， 因 为 它 
会 被 在 HS 级 别 设 置 的 另 一 个 页 面 所 取代 。 
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ls) Panager 


3 Internet Information Servi = (Is) h OOOO 
@C 仿 ， MY-LAPTOP ， Sites » Default Web Site » 


Ple View Help 


本 .NET Error Pages 


“日 ee oi Wr Use this feature to configure HTTP error responses, The error Edit Feature Settings,.. 
| Application Pools responses can be custom error pages, or detailed error messages © 
4 -加 | Sites that contain troubleshooting information, Sp 
.Default Web Site Online Help 
Group by: No Grouping 


Redirect 


Status Code: 
二 口中 
Example: 404 or 300 


Absolute URL: 
| 


Example: http:/ /www.contoso.com/404.aspx 


4 ] Features View |G3 Content View 
Configuration: ‘Default Web Srte web.config 


5-3 定义 TS 级 别 的 自 定义 错误 页 面 


为 了 确保 绕 过 IIS 的 错误 处 理 ， 请 将 TrySkiplNisCustomErrors 属性 设置 为 tue。 该 属性 只 
对 在 IS 7 集成 管道 模式 下 运行 的 应 用 程序 有 用 。 在 集成 管道 模式 下 , 该 属性 的 默认 值 是 false。 
例如 ，HandleError 寞 利 科 选 器 的 实现 ， 束 会 仔细 考虑 这 一 特性 ， 并 将 该 属性 设置 为 true。 


5.3 本 地 化 


本 地 化 的 整个 主题 在 NET Framework 中 并 不 算 新 鲜 ， 在 ASPNET 中 也 不 例外 。 从 
ASPNET 的 第 一 个 版 本 开始 ， 就 有 工具 编写 区 域 特性 的 页 面 了 。 其 好 处 就 在 于 一 切 都 没有 改 
变 ， 因 此 将 本 地 化 功能 添加 到 ASPNET MVC 应 用 程序 不 会 比 在 经 典 的 ASPNET 中 更 难 ， 
也 不 会 有 太 大 的 差别 。 

从 预期 寿命 不 短 的 整个 应 用 程序 的 角度 来 考虑 本 地 化 ， 有 三 个 方面 的 问题 需要 解决 : 如 
何 让 (所 有 ) 资 源 本 地 化 ， 如 何 添加 对 新 区 域 的 文 持 ， 以 及 如 何 将 数据 库 用 作 ( 或 是 否 将 数据 库 
用 作 ) 本 地 化 信息 的 存储 位 置 。 
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5.3.1 使 用 可 本 地 化 的 资源 


资源 就 是 你 希望 适应 于 特定 区 域 性 的 用 户 界 面 项 。 资 源 跨 越 整 个 应 用 程序 ， 并 不 限于 要 
翻译 的 文本 。 我 建议 忘记 老式 的 ASPNET Web Forms 的 做 法 ， 勾 勒 出 你 自己 的 特定 于 现代 
Web 应 用 程序 的 资源 管理 策略 。 这 种 策略 基于 两 大 文 柱 ， 即 : RESX 资源 文件 的 组 织 和 内 容 
的 粒度 。 

RESX 文件 的 作用 是 什么 ? 

RESX 文件 归根 结 压 是 由 Visual Studio 设计 器 在 运行 中 编译 的 XML 文件 。 作 为 开发 人 员 ， 
你 能 够 部 分 控制 名 称 空 间 ， 还 能 访问 类 成 员 的 修饰 符 。 换 句 话 说 ， 当 你 在 项 目 中 添加 一 个 资 
源 时 ， 可 以 选择 是 否 让 所 有 的 属性 公开 化 或 者 内 部 化 (默认 情况 )， 并 决定 哪个 名 称 空间 对 其 
进行 分 组 。 如 果 在 它们 自己 的 程 订 集中 编译 资源 ， 那 么 公共 修饰 符 就 是 必要 的 。 


1. 可 本 地 化 的 文本 


可 本 地 化 的 文本 是 依然 可 以 便利 地 留 在 经 典 RESX 文件 中 的 唯一 一 种 资源 。 从 我 在 实战 
中 所 总 结 的 经 验 来 看 ， 用 单个 全 局 文件 来 存放 所 有 可 本 地 化 的 资源 变 成 了 一 种 不 太 愉 快 的 体 
验 ， 即 便 对 一 般 复 杂 的 应 用 程序 来 说 也 是 如 此 。 

问题 之 一 是 文件 大 小 增长 得 太 快 ,问题 之 二 更 令 人 苦恼 ， 多 个 开发 人 员 可 能 会 在 同一 个 
文件 上 做 并 发 编辑 ， 随 后 还 需要 做 连续 的 合并 。 但 是 ， 我 支持 你 不 要 忽略 命名 问题 。 当 有 几 
百 个 涵义 整个 应 用 程序 范围 的 字符 串 时 ， 你 该 如 何 对 其 命名 ? 许多 字符 串 看 起 来 相同 ， 或 仅 
在 细微 之 处 存 有 不 同 。 许 多 字符 串 出 于 某 些 合理 的 原由 不 是 完整 的 字符 串 ; 它们 往往 是 位 数 
以 及 一 些 需要 由 动态 生成 的 内 容 去 完成 的 文本 片段 。 相 信 我 : 在 只 有 一 些 页 面 的 限制 内 容 的 
条 件 下 对 其 中 一 些 进 行 命名 是 可 行 的 ; 但 要 处 理 用 于 整个 应 用 程序 的 数 以 百 计 的 命名 ， 的 确 
十 分 困难 。 

总 的 来 说 ， 最 好 的 办 法 是 使 用 多 个 资源 文件 。 理 想 情况 下 ， 你 会 希望 每 个 视图 有 一 个 
RESX 文件 。 这 不 一 定 会 导致 文件 的 泛滥 : 对 于 一 个 复杂 度 最 小 的 视图 ， 单 独 的 RESX 文件 
会 使 本 地 化 的 过 程 容易 得 多 ， 且 更 易于 管理 。 

至 于 文件 分 组 ， 我 建议 创建 一 个 以 调用 视图 的 控制 器 命名 的 子 文件 来。 具体 来 说 ， 这 意 
味 着 在 你 的 项 目 中 创建 一 个 Resources 文件 来 ， 其 中 包含 分 布 在 一 堆 依据 茶 些 标准 所 组 织 的 
子 文件 夹 中 的 多 个 RESX 文件 。 可 能 为 每 个 逻辑 功能 区 域 分 配 一 个 文件 ， 或 者 更 好 的 情况 可 
以 是 每 个 控制 器 一 个 。 一 个 Shared 子 文件 夹 可 能 有 助 于 将 资源 文件 以 及 从 多 个 视图 中 引用 的 
内 容 收 集 到 一 起 。 图 5-4 显示 了 一 个 对 多 个 文件 进行 分 组 的 Resources 文件 夹 。 

放置 在 这 样 的 RESX 文件 中 的 字符 串 都 是 全 局 性 的 ， 并 且 可 以 从 任何 视图 和 控制 器 类 中 
引用 。 下 面 是 Razor 中 所 需 的 代码 段 : 
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台 | 四 -= 已 敢 入 | 天 所 


search Solution Explorer (Ctrl+e) 


4 dE MiultiLanguage 
+k Properties 
9 面 References 
别 Common 
面 Content 
别 Controllers 
| Resources 
4 屋 | Menus 
b + Menu.it.resx 
bp + Menu.resx 
二 层 | Text 
bp +[ 本 Strings,itresx 
bp +[ Stringssresx 
ViewModels 
Views 
+ Global.asax 
+ Web,config 
solution Explorer E03 = 


图 5-4 目 定 义 Resources 闵 件 来 


@using MultiLanguage.Resources.Text; 


<p>Q@Strings .OurServices</p> 


上 面 的 表达 式 保证 了 能 够 检索 和 显示 语言 中 性 值 或 本 地 值 。 资 源 管理 器 会 选 出 适用 于 当 
前 区 域 性 的 程 订 集 资源 。 

所 有 使 用 默认 语言 的 RESX 文件 都 会 被 编译 到 与 应 用 程序 相同 的 程序 集中 。 这 就 是 文件 
名 称 不 包含 区 域 性 引用 的 情况 ， 例 如 errors.resx、strings.resx、menus.resx 等 。 区 域 性 特定 的 
资源 在 单独 的 程序 集中 编译 ， 一 个 区 域 一 个 。 将 文本 本 地 化 到 一 个 区 域 只 要 通过 添加 一 个 新 
的 RESX 文件 ， 并 根据 下 面 所 示 的 模式 命名 即 可 : 


filename .XX.resx 


在 这 里 ，XX 代表 区 域 的 首 两 个 字母 : 例如 ，it、 丰 、en、es、de 等 。 那 些 本 地 化 文件 是 
原始 (非特 定 区 域 性 ) 文 件 的 副本 ， 并 仅 会 将 文本 转译 成 对 应 语言 。 


小 贴 士 : 

I 资源 甚至 是 默认 资源 保存 在 它们 自己 的 程序 集中 。 你 只 需要 创建 一 
个 新 的 类 库 项 目 , 将 Resources 文件 夹 拖 放 进 去 (包括 本 地 化 的 版 本 )， 并 从 主 应 用 程 友 引 用 这 
个 库 . 


在 ASPNET MVC 中 ， 在 项 目 内 部 组 织 文 件 的 另 一 个 有 效 方法 是 将 所 有 资源 分 组 到 默认 
的 Content 文件 夹 中 。 在 我 当前 的 项 目 中 ，Content 中 有 Scripts、Styles、Images 和 Text 子 文 
件 夹 。Text 子 文件 夹 包含 RESX 文件 ， 而 RESX 文件 被 限制 为 字符 串 。 
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2. 可 本 地 化 的 文件 


在 ASPNET MVC 中 ， 普 遍 使 用 Url.Content 方法 来 引用 内 容 文 件 ， 比 如 图 片 或 样式 表 。 
这 种 方法 的 主要 好 处 是 它 能 显 式 地 将 相对 路 径 转换 为 绝对 路 径 。 具 体 来 说 ， 该 方法 可 以 解析 
波浪 号 (-) 运 算 符 。 当 运用 于 URL 时 ， 波 浪 号 运算 符 能 够 指示 根 路 径 ， 不 论 根 路 径 是 什么 ， 
或 你 的 应 用 程序 是 侍 被 部 普 为 根 应 用 程序 或 子 应 用 程序 。 因 此 ， 我 号 古 建议 通过 Url.Content 
引用 外 部 文件 。 

如 宁 此 方法 可 以 处 理 本 地 化 工作 电 不 是 也 很 好 ?比如 说 你 请 求 路 径 welcome.jpg, 如 果 当 
前 区 域 性 是 ITT( 指 国家 ， 不 是 部 门 )， 则 返回 welcome.itjpg。 这 一 方法 本 身 不 能 改动 ; 但 是 ， 
如 这 里 所 示 ， 编 写 一 个 扩展 方法 从 而 扩展 Url.Content 语法 却 很 容易 : 


public static class UrlExtensions 


{ 
public static String Content (this UrlHelper helLpeTr， 
String contentPath, Boolean localizable=false) 
{ 

Var url = contentPath,; 

1f (localizable) 
url = GetLocalizedUrl (helper, url); 

return helper.Content (url); 

} 
public static String GetLocalizedUrl (UrlHelper helper, String resourceUrl]) 
{ 

Var cultureExt = String.Format (~{0} {1}", 
Thread.currentThread.CurrentUICulture.TwoLetterIlISoOLanguageName, 
Path.GetExtension (resourceUrl)): 

Var url = Path.ChangeExtension (resourceUrl, cultureExt); 

// Check if localized URL exists, and return file.XX.Jpg (or whatever) 

return VirtualFileExists (helper, url) 2? url : resourceUr]l; 

} 
public static Boolean VirtualFileExists (UrlHelper helper, String url) 
{ 

var ful1VIrtualPath = helper.Content (url); 

Var physicalPath = helper.RequestContext. HttpContext .Server .MapPath 
(fullVvirtualPath); 

return File.Exists (physicalPath); 

} 
} 
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基本 上 来 说 ， 新 的 Content 方法 是 对 UrlLContent 的 一 个 简单 封装 。 访 方法 会 检验 是 否 存 
在 本 地 化 的 资源 。 如 果 确 实 存 在 , 该 方法 即 返 回 本 地 化 的 URL; 否则 , 它 会 返回 原始 的 URL。 
下 面 是 如 何 使 用 该 方法 的 一 个 示例 : 


Qusing BookSamples.Components.Localization; 


<link href="@Url.Content ("~/content/site.css", localizable:true}™ rel= 
"stylesheet™" type="text/css™" /> 
请 记 住 你 引用 的 资源 类 型 (图 片 .样式 表 或 脚本 ) 是 不 相关 的 ; Content 方法 只 是 处 理 URL， 
并 在 条 件 适用 的 时 候 更 改 扩展 名 。 


3. 引用 蕨 入 文件 


当 你 在 一 个 程序 集 的 资源 部 分 峙 入 文件 (脚本 、CSS 或 图 片 ) 时 ， 你 需要 做 一 些 额外 的 工 
作 来 检索 它 。 然 而 从 积极 的 一 面 看 ， 你 不 需要 分 别 部 署 文件 ， 部 灵 程 序 集 就 行 了 。 

在 程序 集中 骨 入 资源 有 两 种 方式 。 可 以 在 RESX 文件 中 添加 资源 文件 。 打开 RESX 文件 ， 
使 用 设计 亏 界 面 提取 出 现 有 的 图 片 或 创建 一 个 新 的 图 片 。 图 睛 是 作为 位 图 对 象 人 存储 在 程序 集 
资源 中 的 。 可 以 通过 使 用 ResourceManager 类 或 HttpContext 类 上 的 GetGlobalResourceObject 
方法 来 检索 该 信息 (后 者 只 适用 于 RESX 文件 放 在 老式 的 App_GlobalResources 文件 夹 中 )。 
在 这 两 种 情况 下 ， 都 不 能 将 程序 集中 的 内 容 转换 成 可 以 附加 到 HIML 标记 的 URL。 一 种 可 
能 的 情况 是 创建 一 个 特 设 的 控制 器 方法 ， 如 下 所 示 : 

public Object Image (String name) 

{ 

Var bits = (Bitmap) HttpContext.GetGlobalResourceObject ("AllResources", 
name);} 

Response.ContentType = "image/Jpeg"; 

blts.Save (Response.Outputstream, ImageFormat.Jpeg); 

return bits; 


} 
<img> 标 记 看 起 来 如 下 : 
<1img alt="™" src="/home/image?name=trees"™" /> 


一 个 更 好 的 方法 是 将 资源 作为 一 个 单独 的 散 入 资源 添加 到 程序 集 。 图 5-5 显示 了 如 何 用 
一 个 JPEG 图 片 来 实现 这 一 点 。 将 图 片 添加 到 你 的 项 目 ， 然 后 将 生成 操作 更 改 为 Embedded 


Resource。 
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各 | -el 
Search Solution Explorer (Ctrlt+e) 


4 +E] EmbRes 
+ Properties 
b ma References 
4 | App_GlobalResources 
b +[ 区 AllResources.resx 
+ treesjpg 
b 面 Common 
4 到 | Content 
4 | Images 
bp 上 呆 Scripts 
bp Styles 
bp Ml Controllers 
bp ViewModels 
bp Ml Views 
Solution Explorer E30 


Properties 
GermanSshep.jpg File Properties 
回 至 > 
| £ 
Browse to URL 
Build Action Embedded Resource 


Copy to Output Directory Do not copy 
Custom Tool 


Custom Tool Namespace 
File Name 


Germanshep.pg 
Browse to URL 


图 5-5 将 图 片 作 为 笠 入 资源 瀛 加 


接 下 来 更 重要 的 是 ， 把 你 的 程序 集 修饰 成 一 个 包含 租 入 资源 的 程序 集 。 在 Properties 项 
日 文件 夹 的 AssemblyInfo 文件 中 添加 以 下 内 容 : 


[assembly: WebResource ("EmbRes.Content.Images.Germanshep.Jpg", 
"limage/Jpg")] 


路 径 就 是 资源 的 完全 限定 名 称 。 如 果 要 检索 资源 ， 只 需要 在 Razor 中 这 样 做 : 
国 | 
var p = new Page(); 
var url = p.Clientscript.GetWebResourceUr] (typeof (MvcApplication), 
"EmbRes .Content .GermanSshep.Jpg"); 
} 


<1mg alt="™ src="@uril™ /> 


另 一 个 需要 考虑 的 问题 是 GetWebResourceUrl 的 第 一 个 参数 。 将 其 设置 为 应 用 程序 的 类 
型 束 好 。 图 5-6 展现 了 所 显示 的 图 上 厂 。 
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4] 


A 


5-6 ”显示 嵌入 资源 中 的 图 卢 
4. 可 本 地 化 的 视图 


视图 是 应 用 程序 中 可 能 需要 适应 当前 区 域 设置 的 男 外 一 个 部 分 。 在 ASPNET MVC 中 ， 
你 要 从 操作 方法 的 内 部 调 出 视图 。 男 外 ， 每 一 个 从 控制 器 调用 的 视图 可 以 包括 可 能 也 需要 进 
行 本 地 化 的 部 分 视图 。 这 意味 着 你 需要 在 两 个 层面 添加 本 地 化 功能 ， 使 用 操作 方法 和 扩展 方 
法 ， 扩 展 方法 通常 用 于 链接 部 分 视图 。 

问 操 作 方 法 添加 本 地 化 逻辑 的 最 好 方法 是 通过 操作 沛 选 嚣 来 实现 。 在 结束 时 ， 你 需要 做 
的 只 是 通过 算法 确定 视图 的 名 称 并 调用 它 。 操 作 筛 选 器 使 代码 保持 整洁 ， 并 将 本 地 化 逻辑 移 
到 可 以 单独 进行 管理 的 其 他 地 方 。 可 以 在 第 8 章 读 到 更 多 有 关 操 作 筛 选 器 的 信息 。 现 在 ， 让 
我 们 把 注意 力 集 中 到 HIML 扩展 上 ， 以 调用 本 地 化 的 部 分 视图 。 

在 ASPNET MVC 中 ， 当 你 只 想 呈 现 视图 的 时 候 要 使 用 Html.RenderPartial; 当 你 想 要 取 
HTML 标记 并 自己 编写 到 流 时 , 要 使 用 Html.Partial。 这 里 添加 本 地 化 的 逻辑 与 我 们 早先 用 
于 资源 文件 的 过 程 几乎 相同 。 下 面 是 扩展 Partial 的 一 个 新 的 HTML 扩展 方法 。 

public static class PartialExtensions 


{ 
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public static MvcHtmlstring Partial (this HtmlHelper htmlHelpPper， 
String partialViewName, Object model, ViewDataDictionary viewData, 
Boolean localizable = false) 


// Attempt to get a localized view name 
Var viewName = partialViewName; 
1f (localizable) 
viewName = GetLocalizedViewName (htmlHelper, viewName); 


// Call the system Partial method 
return SYstem.Web .Mvc .Html .PartialExtensions.Partial (htmlHelper, 
viewName, model, viewData); 


public static MyvcHtmlstring Partial (this HtmlHelper htmlHelper, String 
partialViewName,Boolean localizable=false) 


// Attempt to get a localized view name 
Var viewName = partialViewName; 
1f (localizable) 
viewName = GetLocalizedViewName (htmlHelper, vliewName); 


// Call the system Partial method 
return htmlHelper.Partial (viewName, null, htmlHelper.ViewData); 


public static String GetLocalizedViewName (HtmlHelper htmlHelper, 
string partialViewName) 


var urlHelper = new UrlHelper (htmlHelper.ViewContext .RequestContext),; 
return UrlExtensions.GetLocallizedUrl (urlHelper, partialViewName); 


} 

代码 的 结构 是 相当 直观 的 。 新 方法 会 根据 既定 的 约定 来 检查 是 人 否 存 在 本 地 化 的 视图 。 如 
果 确 实 存在 ， 该 方法 会 进一步 调用 带 有 本 地 化 名 称 的 原始 Partial 方法 ; 否则 ， 一 切 照 约定 进 
行 。 额 外 的 步 又 可 以 通过 可 本 地 化 的 Boolean 参数 得 以 控制 : 


Qusing BookSamples.Components.Localization; 


@Html .Partial(" aboutdetails", localizable:true) 


用 于 RenderPartial 的 代码 几乎 相同 ， 可 以 在 下 载 的 源 代 但 中 找到 。 


182 


第 5 章 ASPNET MVC 应 用 程序 的 特性 


5.3.2 ”处 理 可 本 地 化 的 应 用 程序 


到 目前 为 止 ， 你 已 经 看 到 了 个 别 必须 本 地 化 的 资源 是 如 何 处 理 的 。 然 而 ， 将 应 用 程序 本 
地 化 不 仅仅 需要 本 地 化 单个 资源 的 集合 。 尤 其 是 ， 你 应 该 有 一 个 清晰 的 概念 ， 打 算 通 过 本 地 
化 应 用 程序 来 达成 什么 目的 。 硕 望 应 用 程序 能 够 文 持 多 种 语言 ， 但 要 在 安装 时 配置 每 种 语言 
吗 ? 或 者 ， 你 希望 用 户 能 够 在 预定 义 的 语言 之 间 进 行 切换 吗 ? 又 或 者 ， 你 最 终 要 的 是 一 个 目 
适应 的 应 用 程序 吗 ? 我 们 来 检视 一 下 这 三 种 情形 。 


1. 自 适 应 的 应 用 程序 


自 适 应 的 应 用 程序 是 基于 用 户 提 供 的 信息 ， 以 某 种 方式 确定 要 使 用 的 区 域 性 的 应 用 程 
序 。 这 样 的 应 用 程序 文 持 大 量 的 预定 义 区 域 性 ， 并 且 当 检测 到 区 域 设 置 不 匹配 任何 所 文 持 的 
区 域 性 时 即 退 回 到 非特 定 的 区 域 性 。 非 特定 区 域 性 就 是 应 用 程序 的 本 机 默认 语言 。 非 特定 区 
域 性 资源 是 指 那些 名 称 中 不 包含 任何 区 域 性 的 人 D。 

自 适 应 应 用 程序 的 最 典型 特征 是 该 应 用 程序 如 何 确 定 要 使 用 的 区 域 性 。 通 种 有 几 种 方 
式 。 最 常见 的 方式 是 要 让 应 用 程序 读 取 随 浏 览 器 所 发 送 的 各 个 请 求 的 可 接受 语言 列表 。 男 一 
种 方式 是 基于 地 理 位 置 ,应 用 程序 的 服务 器 端 部 分 以 某 种 方式 获取 当前 用 户 (P 地 址 或 客户 端 
地 址 ) 的 位 置信 息 并 选择 相应 的 区 域 性 。 第 一 种 方法 直接 由 ASPNET 运行 时 提供 ;第 二 种 方 
法 则 需要 你 进行 一 些 额外 的 工作 ， 并 可 能 使 用 一 些 额外 的 框架 。 让 我 们 来 检视 第 一 种 方法 。 

在 ASPNET 中 , 可 以 使 用 Culture 和 UICulture 属性 来 获取 和 设置 当前 区 域 性 。 这 是 在 每 
个 请 求 的 基础 上 一 一 例如 ， 从 各 控制 器 类 的 构造 函数 内 部 ,或 一 些 控制 器 基 类 的 构造 函数 中 。 
Culture 属性 文 配 所 有 应 用 程序 范围 的 设置 ， 如 日 期 、 货 币 和 数字 。UICulture 属性 控制 用 于 
加 载 资源 的 语言 。 这 些 字符 串 属性 可 以 被 ASPX 和 Razor 视图 引擎 中 的 视图 类 公开 获取 。 

请 注意 这 两 个 属性 默认 为 空 字 符 串 , 这 意味 着 默认 区 域 性 就 是 设置 在 Web 服务 器 上 的 区 
域 性 。 如 果 区 域 性 属性 设置 为 自动 ， 则 由 浏览 器 通过 Accept-Languages 请 求 标 头发 送 的 首选 
语言 会 被 选 出 。 要 让 视图 自动 本 地 化 (如 果 用 于 那个 区 域 性 的 资源 可 用 )， 必 须 问 web.config 
文件 添加 下 列 行 : 


<Ssystem.web> 


<globalization culture="auto™ ulCulture="auto™ /> 
</system.web> 


要 让 日 适应 的 本 地 化 应 用 程序 局 动 和 运行 , 这 就 是 你 唯一 需要 做 的 (除了 使 用 本 地 化 的 资 
源 之 外 )。 
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2. 多 语言 应 用 程序 


另 一 种 可 能 的 情形 是 ， 当 你 有 一 个 部 署 了 多 个 本 地 化 程序 集 的 多 语言 应 用 程序 ， 却 被 配 
置 为 只 能 使 用 一 个 资源 集 。 同 样 ， 在 这 种 情况 下 ， 你 不 用 在 任何 位 置 编写 特 设 的 代码 ， 只 需 
要 在 web.config 文件 的 全 球 化 部 分 写 入 正确 的 信息 : 


<SyYStem.wWeD> 


<gqlobalization culture="it™ uiCulture="it™ /> 


</system.web> 
当然 , 此 外 你 要 使 区 域 性 特定 的 资源 可 用 , 以 便 它们 可 以 通过 ASPNET 框架 被 目 动 调用 。 


3. 以 编程 方式 更 改 区 域 性 


但 是 ， 大 多 数 情况 下 ， 你 只 想 能 够 以 编程 方式 设置 区 域 性 ， 以 及 在 用 户 通过 单 击 图 标 或 
使 用 区 域 性 特定 的 URL 切换 到 不 同 的 区 域 性 时 能 够 动态 更 改 区 域 性 。 

当 你 要 以 编程 方式 更 改 区 域 性 时 ， 你 需要 满足 两 个 关键 要 求 。 首先 ， 定 义 要 用 于 检索 区 
域 性 设置 的 策略 。 该 梨 上 略 可 以 是 从 系 些 数据 库 表 或 ASPNET 绥 存 中 所 读 取 的 值 。 也 可 以 是 从 
URL 中 所 检索 的 值 。 最 后 ， 它 也 可 以 是 你 通过 地 理 位 置 获取 的 参数 一 一 即 通过 但 看 用 户 连 接 
的 四 地址。 在 任何 情况 下 ， 某 一 时 刻 你 总 会 知道 标识 要 设置 区 域 性 的 神奇 字符 串 。 那 么 你 如 


何 应 用 它 呢 ? 
下 面 的 代码 显示 了 与 要 使 用 的 区 域 性 有 关 的 需要 加 ASPNET 运行 时 所 指示 的 内 容 : 
Var culture = "”-.--";， // 1.e-，1t-IT 


var cultureInfo = CultureInfo.CreateSpecificCulture (culture); 
Thread.currentThread.Currentculture = culjtureInfo; 
Thread.currentThread.CurrentUICulture = cultureInfo; 


选取 ASPNET 当前 线程 ， 并 设置 CurrentCulture 和 CurrentUICulture 属性 。 请 注意 两 个 
区 域 性 属性 不 一 定 具 有 相同 的 值 。 例 如 ， 可 以 根据 浏览 器 的 配置 切换 文本 语言 和 消息 ， 同 时 
保留 全 球 化 设置 (如 日 期 和 货币 ) 凋 数 。 

必须 为 每 一 个 请 求 设置 区 域 性 ， 因 为 每 个 请 求 都 在 它 自己 的 线程 上 运行 。 在 ASPNET 
MVC 中 ， 可 以 用 多 种 方式 实现 这 一 点 。 例 如 ， 可 以 将 前 面 的 代码 租 入 到 一 个 控制 器 基 类 。 
这 将 强制 从 给 定 的 基 类 派生 所 有 的 控制 嚣 。 如 果 先 得 这 不 可 接受 ， 或 者 就 是 想 采 用 男 一 个 路 
由 , 则 可 以 借助 于 一 个 自 定 义 操作 调用 程序 或 全 局 操作 筛选 器 (第 8 章 会 介绍 调用 程序 和 操作 
虽 选 句 的 更 多 信息 )。 在 这 两 种 情况 下 ， 可 以 一 次 性 编写 代码 ， 并 一 步 式 将 其 附加 到 所 有 的 控 
制 荆 。 以 下 是 使 用 全 局 和 猎 选 喜 进 行 本 地 化 的 代码 : 


[AttributeUsage (AttributeTargets.class|AttributeTargets .Method ， 
AllowMultiple=false, Inherited=true)] 
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public class CultureAttribute : ActionFilterAttribute 
{ 


private const string CookieLangEntry = "lang"; 


public String Name { get; set; } 
public static String CookieName 
{ 


get { return "” LangPref"; } 


public override vold OnActionExecuting (ActionExecutingContext 
filtercontext) 


var culture = Name; 
1f (String.IsNullOorEmpty (culture)) 
culture = GetsavedCultureorDefault 
(filterCcontext.RequestcContext .HttpContext .Request); 


/:/ Set culture on current thread 
SetCultureonThread (culture); 


/ / Proceed as usual 
base.OnActionExecuting (filterContext);} 


public static void SavePreferredCulture (HttpResponseBase response, 
String language., 
Tnt32 explreDays=1) 


Var Cookie = new HttpCookie (CookieName) { Explres = 
DateTime .Now.AddDays (explreDays) }; 
cookie.Values[CookieLangEntry] = language; 
response.Cookies.Add (cookie); 


public static String GetSavedCultureorDefault (HttpRequestBase 


httpRequestpBase) 
{ 
Var Culture = ™"s 
Var cookie = httpRequestBase.Cookies[CookieNamel]; 
1f (cookie != null]l) 
culture = cookie.Values [CookieLangEntry]; 


return culture: 
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private static void SetcultureonThread (string language) 


{ 
Var cultureInfo = CultureInfo.CreateSpecificCulture (language); 
Thread.currentThread.CurrentCulture = culjturelInfo; 
Thread.currentThread.CurrentUICulture = cultureInfo; 

} 


} 

CultureAttribute 类 提供 了 将 特定 区 域 性 字符 串 读 写 到 自 定义 cookie 的 公共 静态 方法 。 筛 
选 器 重 写 了 OnActionExecuting 方法 ,这 意味 着 它 可 能 在 任何 控制 器 方法 运行 之 前 介入 。 但 是 ， 
要 实现 这 一 目的 ， 算 选 器 必须 注册 为 全 局 科 选 器 。 在 实现 OnActionExecuting 的 过 程 中 ， 沛 
选 器 会 读 取 之 前 存储 到 cookie 的 用 户 首选 的 区 域 性 ， 并 将 它 设 置 到 当前 的 请 求 线程 。 

下 面 的 代码 显示 了 如 何 把 筑 选 苍 广 册 成 运用 于 应 用 程序 中 所 有 控制 亏 方 法 的 全 局 师 选 规 : 


public class MvcApplication : HttpApplication 


{ 
public static void ReglisterGlobalFilters (GlobalFilterCollection filters) 
{ 
filters.Add (new HandleErrorAttribute()); 
filters.Add (new CultureAttribute () ) ; 
} 
} 


有 了 这 种 基础 染 构 , 就 可 以 将 链接 添加 到 你 的 网 页 ( 通 弟 是 母 版 页 ) 以 便 在 运行 中 切换 语言 : 


@Html .ActionLink (Menu.Lang IT, "Set", "Language", new { lang = "it™ }, null) 
@Html .ActionLink (Menu.Lang EN, "Set", "Language", new { lang = "en™ }, null) 


要 遵循 上 面 的 操作 ， 你 需要 使 用 一 种 操作 方法 。 我 喜欢 将 此 代码 单独 放 在 一 个 特定 的 控 
制 顷 ， 如 下 面 有 所 示 的 LanguageController 关 : 


public class LanguageController : Controller 


{ 
public vold Set (String lang) 
{ 
// Set culture to Use next 
CultureAttribute.SsSavePreferredCulture (HttpContext .Response, lang); 
// Return to the calling URL (or go to the site's home page) 
HttpContext.Response.Redirect (HttpContext.Request .UrlReferrer. 
AbsolutepPath);} 
} 
} 
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该 操作 方法 会 直接 将 新 选 定 的 语言 存储 到 你 选择 的 存储 区 中 一 一 在 本 示例 中 是 一 个 自 定 
义 cookie 一 一 并 重 定 癌 。 图 5-7 显示 了 一 个 可 以 以 多 种 语言 显示 其 内 容 的 示例 页 。 


全 有 局 nttpsNilocalhost:3593) 


. . ltaliano Inglese 
ltalian English 


| a a Per maggiori informazioni: expoware.org. 
To learn more about our services, vislt expoware.org. 


Ecco gualcosa di interessante... 


配 150% 


图 5-7 用 户 可 以 在 运行 中 切换 语言 的 应 用 程序 
无 论 用 于 确定 所 需 语 言 的 技术 是 通过 选择 、 卫 地 址 还 是 地 理 位 置 , 都 可 以 应 用 这 种 方法 。 


注意 : 
越 来 越 多 的 网 站 从 用 户 的 连接 中 核查 位 置信 息 ， 并 推荐 一 种 语言 和 区 域 性 。 此 功能 需要 
一 个 查找 全 地址 的 API， 并 将 其 映射 到 一 个 国家 ， 然 后 是 一 个 区 域 。 


在 数据 库 中 存储 本 地 化 资源 

在 讨论 本 地 化 的 时 候 ， 似 乎 不 可 避免 地 会 谈 到 数据 库 作为 本 地 化 数据 的 可 能 存储 区 。 这 
是 一 个 可 选项 吗 ? 答案 是 肯定 的 。 然 而 ， 有 一 些 优 缺 点 需要 考虑 。 

首先 ， 使 用 数据 库 会 增加 延迟 ， 即 使 你 不 会 为 要 本 地 化 的 视图 的 每 一 部 分 进行 数据 库 的 
调用 。 相 反 ， 最 有 可 能 的 情况 是 你 读 取 一 串 记录 并 将 其 缓存 很 长 时 间 。 因 此 ， 通 过 以 这 种 广 
式 使 用 数据 库 所 表现 出 的 性 能 影响 比 人 们 第 一 印象 中 想象 的 破坏 性 要 小 。 

在 数据 库 中 存储 本 地 化 数据 需要 一 个 自 定义 的 本 地 化 层 ， 而 通过 经 典 的 基于 XML 的 次 
源 文件 的 方法 不 会 导致 你 编写 很 多 额外 的 代码 ， 并 为 你 提供 来 自 Visual Studio 设计 器 的 出 色 
支持 。 

当 视图 的 数量 变 得 庞大 (比如 数 百 个 ) 时 ， 资 源 项 的 数目 至 少 会 增 至 数 以 千 计 。 这 时 ， 管 
理 它们 会 变 得 棘手 。 你 可 能 会 有 很 多 加 载 到 AppDomain 占用 运行 时 内 存 的 程序 集 , 这 将 对 站 
点 的 整体 性 能 造成 影响 。 因 此 ， 数 据 库 或 许 是 大 部 分 本 地 化 内 容 的 最 好 方式 。 

存储 在 关系 数据 库 中 的 数据 更 易于 管理 、 查 询 和 缓存 ， 且 大 小 不 是 问题 。 此 外 ， 有 了 数 
据 库 和 自 定义 的 本 地 化 层 ， 可 以 在 本 地 资源 的 整体 检索 过 程 中 获得 更 多 的 灵活 性 。 事 实 上 ， 
可 以 让 本 地 化 层 提供 一 组 字符 串 一 或 者 ， 更 好 的 是 提供 原始 数据 一 然后 格式 化 以 满足 用 
户 界面 的 需要 。 换 句 话说 ， 自 定义 的 本 地 化 层 会 将 你 从 维护 资源 项 与 用 户 界面 特定 片段 之 间 
的 直接 绑 定 之 中 解 焰 出 来 。 
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4. 从 服务 中 获取 本 地 化 数据 


来 目 移 动 应 用 程序 的 另 一 种 受 欢 迎 的 选择 是 从 本 地 化 的 服务 中 获取 数据 。 该 服务 可 以 由 
筹备 网 站 的 同一 个 团队 拥有 ， 甚 至 也 可 以 是 一 些 第 三 方 服务 。 更 重要 的 是 ， 此 方法 可 以 使 你 
以 最 小 的 工作 量 添 加 新 的 语言 ， 同 时 随 痢 时 间 的 推移 还 可 提高 已 翻译 文本 的 质量 ， 而 无 须 重 
新 部 闭 任 何 新 的 内 容 。 


注意 : 
基于 外 部 服务 的 方法 和 使 用 本 地 数据 库 的 方法 可 以 封 半 在 一 个 ASPNET 资源 提供 程序 
中 一 一 一 个 使 用 IResourceProvider 接口 的 类 。 


5.4 本章 小 结 


在 ASPNET MVC 中 的 应 用 程序 主要 是 Web 应 用 程序 。 现 代 Web 应 用 程序 比 几 年 前 具 
有 更 多 元 化 的 要 求 。 例 如 ， 当 今 的 Web 应 用 程序 必须 是 对 搜索 引擎 友好 的 ， 并 且 很 可 能 必须 
支持 全 面 的 本 地 化 ， 以 便 能 够 通过 利用 用 户 的 特定 语言 和 区 域 性 来 驱动 用 户 的 操作 。 最 后 ， 
提供 声名 狠 夭 的 黄页 面 错误 ( 即 ASPNET 的 一 个 默认 错误 页 面 ) 是 令 人 难以 接受 的 ; 它 仍 然 存 
在 ,但 其 真 的 很 影响 一 个 网 站 的 声誉 (未 处 理 的 错误 一 直 是 一 件 坏 事 , 但 用 户 在 前 几 年 愿意 给 
予 的 容忍 度 绝对 是 过 去 的 事 了 )。 

基于 所 有 这 些 原 因 , 任何 Web 应 用 程序 的 基础 架构 (以 及 在 这 种 上 下 文 环境 下 的 ASPNET 
MVC 应 用 程序 基础 架构 ) 都 需要 更 为 强大 和 丰富 。 尤其 是 , 需要 更 多 关注 你 能 够 识别 的 URL， 
并 设计 用 于 SEO 和 错误 处 理 的 UREL。 你 需要 设计 视图 和 控制 器 以 检查 当前 的 区 域 设置 ， 并 
自动 调整 图 形 和 消息 。 你 还 需要 检测 区 域 性 ， 让 用 户 在 你 所 文 持 的 语言 之 间 进 行 切换 。 

本 章 提 供 了 如 何 进行 ASPNET MVC 开发 的 详尽 概述 。 在 第 6 章 “ 应 用 程序 安全 性 ”中 ， 
我 们 将 讨论 ASPNET MVC 应 用 程序 的 安全 防护 。 


中 


应 用 程序 安全 性 


不 怕 慢 ， 就 怕 停 。 
一 孔子 


安全 对 用 户 和 开发 人 员 来 说 意味 着 很 多 事情 。 在 Web 上 下 文中 ,安全 涉及 防止 在 运行 的 
应 用 程序 中 注入 恶意 代码 。 同 样 ， 安 全 也 涉及 防止 透露 私人 数据 的 操作 。 最 后 ， 安 全 还 涉及 
构建 只 有 通过 身份 验证 和 授权 的 用 户 方 可 访问 的 应 用 程序 (和 应 用 程序 中 的 各 个 部 分 )。 

应 用 程序 开发 人 员 最 常 处 理 的 安全 方面 的 内 容 当 然 是 用 户 的 喘 份 验证 和 授权 。 近 来 ， 越 
来 越 多 的 网 站 也 开始 通过 流行 的 社交 服务 提供 者 实行 身份 验证 。 尽 管 对 任何 应 用 程序 来 说 都 
算 不 上 很 理想 ， 甚 至 有 时 候 用 作成 员 的 唯一 形式 几乎 是 无 效 的 ， 但 社交 服务 身份 验证 正在 变 
得 越 来 越 受 欢迎 。 正 如 你 会 在 本 章 后 面 所 看 到 的 ，ASPNET MVC 通过 面向 社交 服务 的 应 用 
程序 在 网 站 中 提供 了 集成 身份 验证 和 授权 的 配套 设施 。 


6.1 ASP.NET MVC 中 的 安全 性 


ASPNET 提供 了 一 系列 的 映 份 验证 和 授权 机 制 ， 是 将 Internet 信息 服务 (IIS)、 微 软 .NET 
Framework 与 操作 系统 的 底层 安全 服务 结合 起 来 实现 的 。 如 果 IIS 和 ASPNET 应 用 程序 在 集 
成 模式 下 工作 一 一 这 是 目前 IIS 7 及 较 新 版 本 最 常见 的 场景 一 一 则 请 求 会 通过 一 条 单独 的 管 
道 ， 其 中 包括 身份 验证 步骤 和 一 个 可 选 的 授权 步骤 。 如 果 IIS 和 ASPNET 运行 他 们 自己 的 进 
程 , 则 一 些 请 求 可 能 要 在 IIS 入 口 通过 身份 验证 或 授权 , 而 其 他 请 求 ( 比 如 ASPX 页 面 的 请 求 ) 
会 与 已 认证 或 芽 名 用 户 的 IIS 安全 令 牌 一 起 移交 给 ASPNET。 

起 初 ，ASPNET 文 持 三 种 类 型 的 身份 验证 方法 : Windows、Passport 和 Forms。 和 第 4 种 可 
选项 是 None， 意 味 着 ASPNET 甚至 不 会 答 试 执行 自己 的 身份 验证 ， 而 是 完全 依赖 于 由 IIS 
所 执行 的 身份 验证 。 在 这 种 情况 下 ， 匿 名 用 户 可 以 连接 ， 并 且 通 过 使 用 默认 的 ASPNET 账户 
就 可 以 访问 资源 。 虽 然 Passport 身份 验证 现 已 过 时 并 不 再 使 用 ， 但 其 中 一 些 具 有 启发 性 的 原 
则 和 宗旨 被 保留 了 下 来 ， 并 由 新 兴 的 安全 标准 用 于 更 好 的 服务 ， 如 OAuth 和 OpenID 一 一 社 
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交 网 络 喘 份 验 证 背后 的 协议 。 
6.1.1 和 号 份 验证 和 授权 


Windows 身份 验证 很 少 应 用 于 实际 的 互联 网 应 用 程序 。Windows 身份 验证 基于 微软 
Windows 账户 和 NTFS ACL 令 牌 ， 因 此 ， 它 会 假定 客户 端 是 从 运行 Windows 的 设备 连接 的 。 
虽然 这 在 内 网 方案 ， 可 能 还 包括 一 些 外 网 的 方案 中 是 有 用 且 有 效 的 ,但 Windows 号 份 验证 在 
更 多 情况 下 是 不 具有 可 行 性 的 ， 因 为 Web 应 用 程序 用 户 需 要 在 应 用 程序 域 中 拥有 Windows 
账户 。 

表单 身份 验证 是 最 常用 的 收集 和 验证 用 户 赁 据 的 方式 ;例如 使 用 用 户 账 户 数据 库 进 行 
验证 。 


1. 在 ASP.NET MVC 中 配置 身份 验证 


在 ASPNET MVC 和 Web Forms 中 ， 是 通过 根 web.config 文件 中 的 <authentication>= 部 分 
选择 号 份 验证 机 制 的 。 下 级 子 目 录 继 承 了 为 应 用 程序 所 选 的 身份 验证 模式 。 默 认 情况 下 ， 
ASPNET MVC 应 用 程序 会 被 配置 为 使 用 Forms 身份 验证 。 下 面 的 代码 片段 显示 了 一 段 来 自 
ASPNET MVC 中 (我 只 编辑 了 登录 URL) 自 动 生 成 的 web.config 文件 的 摘录 : 

<authentication mode="Forms"> 

<forms loginUrl="~/Auth/Logon™ timeout="2880™ /> 

</authentication> 

以 这 种 方式 配置 后 ， 应 用 程序 会 在 每 一 次 用 户 尝 试 访问 为 通过 续 份 验证 的 用 户 所 保留 的 
URL 时 ， 把 用 户 重 定向 到 指定 的 登录 URL。 但 是 ， 如 何 标识 一 个 需要 号 份 验 证 的 ASPNET 
MVC URL( 比 如 控制 器 方法 ) 呢 ? 


2. 限制 对 操作 方法 的 访问 
当 要 限制 对 某 操作 方法 的 访问 时 ， 请 使 用 Authorize 特性 ， 并 确保 只 有 通过 身份 验证 的 
用 户 可 以 执行 它 。 下 面 是 一 个 示例 : 


[Authorizel] 
public ActionResult Index() 
{ 


} 


如 果 将 Authorize 特性 添加 到 控制 嚣 类， 那么 控制 嚣 上 的 任何 操作 方法 都 将 需要 进行 喘 
份 验证 。 


[Authorizel] 
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public class HomeController 


{ 
public ActionResult Index() 
{ 
} 

} 


Authorize 特性 是 可 继承 的 。 这 意味 着 可 以 将 它 添加 到 你 的 控制 器 基 类 ， 并 确保 派生 控制 
器 的 所 有 方法 都 需要 进行 身份 验证 。 绝 对 不 要 将 Authorize 特性 用 作 全 局 算 选 器 。 事 实 上 ， 下 
面 的 代码 会 限制 对 任何 资源 的 访问 ， 包 括 登 录 页 面 : 


public class MvcApplication : System.Web.HttpApplication 


{ 
public static vold RegisterGlobalFilters (GlobalFilterCollection filters) 
{ 
// Don't do this! 
filters.Add (new AuthorizeAttribute () ) ， 
} 
} 


3. 允许 匿名 调用 方 

ASPNET MVC 提供 了 男 一 种 与 安全 相关 的 特性 : AllowAnonymous 特性 。 当 应 用 于 方法 
时 ， 和 它 会 指示 ASPMVC 运行 时 在 调用 方 未 通过 映 份 验证 时 也 让 其 通过 。AllowAnonymous 
方法 派 上 用 场 的 情况 是 , 当 把 Authorize 应 用 在 类 级 别 时 , 之 后 需要 启用 对 一 些 方法 的 自由 访 
问 ， 尤 其 是 登录 方法 。 

4. 处 理 操作 方法 的 授权 

Authorize 特性 并 不 局 限于 号 份 验证 ; 它 还 文 持 基本 的 授权 形式 。 任 何 用 该 特性 标记 的 方 
法 只 能 由 经 过 身份 验证 的 用 户 执行 。 另 外 ， 可 以 用 规定 的 角色 将 访问 限制 在 一 组 特定 的 通过 
身份 验证 的 用 户 上 。 只 要 通过 给 该 特性 添加 两 个 命名 参数 即 可 实现 这 一 点 ， 如 下 所 示 : 


[Authorize (Roles="admin", Users="DinoE, FrancescoE")|] 
public ActionResult Index{() 
{ 


} 
如 果 用 户 未 通过 里 份 验证 或 没有 提供 所 需 的 用 户 名 称 和 和 角色， 该 特性 会 阻止 对 方法 的 访 
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问 ， 并 将 用 户 重 定 同 到 登录 URL。 在 刚才 所 示 的 示例 中 ， 只 有 DinoE 或 FrancescoE 用 户 对 
方法 有 访问 权 ( 如 果 他 们 是 Admin 角色 的 话 )。 请 注意 Roles 和 Users, 如 果 它 们 被 指定 了 的 话 ， 
将 合并 到 逻辑 AND 运算 中 。 


5. 授权 和 输出 缓存 


如 果 需 要 身份 验证 和 (或 ) 授 权 的 方法 也 配置 为 支持 输出 缓存 呢 ? 输 出 缓存 一 一 具体 来 说 
是 OutputCache 特性 一 一 会 指示 ASPNET MVC 不 必 每 次 都 真正 处 理 请 求 ， 但 要 返回 一 个 先 
前 计算 的 且 依 然 有 效 ( 即 没 有 过 期 ) 的 缓存 响应 。 输 出 缓存 功能 打开 后 ， 用 户 就 可 能 请 求 一 个 
己 在 缓存 中 且 受 保护 的 URL。 那 么 如 何 实现 呢 ? 

ASPNET MVC 确保 了 Authorize 特性 优先 于 输出 缓存 。 尤 其 是 ， 只 有 当 用 户 通 过 了 身份 
验证 和 授权 ， 输 出 缓存 层 才 会 为 处 于 Authorize 中 的 方法 返回 一 个 缓存 的 响应 。 


6. 隐藏 关键 的 用 户 青 面 元 素 


你 可 能 也 和 希望 通过 简单 地 禁用 或 隐藏 那些 能 够 触发 受 限 制 操 作 方 法 的 操作 链接 和 按钮 
来 阻止 用 户 访问 受 限 制 的 资源 。 通 过 检查 当前 用 户 和 所 分 配角 色 的 身份 验证 状态 ， 如 果 用 户 
没有 适当 权限 的 话 ， 就 可 以 关闭 关键 输入 元 素 的 可 见 性 标志 。 

我 喜欢 这 种 做 法 ， 但 不 会 将 其 作为 处 理 角 色 和 权限 的 唯一 解决 办 法 。 最 后 ， 隐 藏 用 户 界 
面 (UD 元 素 ( 这 比 禁用 它们 要 简单 有 效 ) 还 是 很 不 错 的 , 只 要 你 仍然 还 通过 使 用 编程 检查 来 限制 
对 操作 方法 的 访问 。 


6.1.2 ”将 身份 验证 和 授权 分 开 


在 ASPNET MVC 5 之 前 ，Authorize 特性 是 ASPNET MVC 所 支持 的 唯一 与 安全 相关 的 
操作 筛选 器 。 它 可 以 处 理 身 份 验证 和 授权 ， 但 有 时 会 忽略 一 些 细节 。 

为 了 能 够 执行 方法 ，Authorize 特性 首先 会 要 求 对 用 户 进行 身份 验证 。 接 着 ， 如 果 指 定 了 
User、Role 或 两 者 都 被 指定 了，Authorize 特性 就 会 检查 用 户 是 人 否 被 授权 (通过 名 称 和 角色 ) 访 
问 该 方法 。 产 生 的 影响 是 ， 该 特性 最 终 不 是 区 分 用 户 是 否 登 录 ， 而 是 区 分 谁 没 有 权限 调用 给 
定 的 操作 方法 。 事实 上 ,在 这 两 种 情况 下 ， 尝 试 调用 操作 方法 都 会 将 用 户 重 定向 到 登录 页 面 。 

在 ASPNET MVC 5 中 已 添加 了 刁 份 验证 科 选 器 ， 当 刁 份 验证 失败 时 ， 可 以 选择 干预 并 
控制 工作 流 。 但 在 深入 探讨 身份 验证 筛选 器 之 前 ， 让 我 们 先 看 看 如 何 改善 Authorize 特性 以 区 
分 匿名 用 户 和 未 经 授权 的 用 户 。 


1. 匿名 还 是 未 经 授权 
让 我 们 创建 一 个 扩展 内 置 授权 特性 的 增强 特性 类 ， 如 下 所 示 : 


public class AuthorizedonlyAttribute : AuthorizeAttribute 
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public AuthorizedonlyAttribute() 
{ 

View = "error"™; 

Master = String.Empty; 


public String View { get; set; } 
public string Master { get; set; } 


public override vold OnAuthorization (AuthorizationContext filterContext) 
{ 

base.onAuthorization (filterContext).; 

CheckIfUserIsAuthenticated (filterContext).; 


private void CheckIfUserIsAuthenticated (AuthorizationContext 
filterContext) 
{ 
// If Result 15s null, we're OK: the user 1s authenticated and authorized. 
1f (filterContext.Result == null) 
return; 


// If here, you're getting an HTTP 401 status code 
1f (filterContext.HttpContext.User.Identity.IsAuthenticated) 
{ 
if (String.IsNullOorEmpty (View)) 
return; 
Var result = new ViewResult {ViewName = Vliew, MasterName = Master}; 
filterContext.Result = result; 


} 


在 新 的 类 中 ， 需 要 重 写 OnAuthorization 方法 ， 并 运行 一 些 额外 的 代码 来 检查 是 否 获 得 了 
-条 HTTP 401 消息 。 如 果 正 是 这 样 ， 你 之 后 要 检查 当前 用 户 是 耕 通 过 了 身份 验证 ， 并 重 定 
向 到 自己 的 错误 页 面 (如 果 有 的 话 )。 可 以 用 View 和 Master 属性 来 配置 带 有 用 户 说 明 的 目标 
错误 视图 。 
实际 影响 是 ， 如 果 因 用 户 未 登录 导致 你 得 到 一 个 HITP 401 错误 ， 就 会 转 到 登录 页 面 
否则 ， ah 用 户 就 会 收 到 一 个 友好 的 错误 页 面 。 使 用 新 特性 也 不 会 
变 得 更 简单 ， 这 里 就 证 明了 这 一 点 。 


[AuthorizedOonly (Roles="admln"，Users="D1ImoE") ] 
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public ActionResult Index() 
{ 


} 


从 有 效 性 来 看 ， 这 里 呈现 的 解决 方案 的 确 可 以 利用 ， 但 从 设计 的 角度 来 看 ， 可 能 还 不 其 
Ts 


2. 身份 验证 沛 选 器 


在 ASPNETMVC 5 中 ， 身 份 验证 径 选 器 可 以 是 实现 IAuthenticationFilter 接口 的 任何 类 ， 
如 下 所 示 : 


public interface IAuthenticationFilter 
{ 
VOld OnAuthentication (AuthenticationContext filterContext). 
vold OnAuthenticationChallenge (AuthenticationChallengeContext 
filtercontext).; 
} 


本 地 实现 该 接口 的 框架 中 唯一 的 类 是 Controller 类 。 在 内 部 ， 身 份 验证 筛选 器 是 在 传 入 
请 求 上 进行 调用 的 第 一 组 科 选 器 。OnAuthentication 方法 负责 实际 的 身份 验证 逻辑 ,并 决定 验 
证 是 否 真 的 应 该 及 生 。 你 在 这 里 执行 的 任何 操作 都 只 是 艰巨 任务 的 开始 ， 用 户 要 通过 这 些 操 
作 输 入 凭据 或 其 他 信息 。OnAuthenticationChallenge 方法 是 你 在 身份 验证 完成 以 后 将 用 户 重 
定 问 到 登录 页 面 或 任何 附加 页 面 的 地 方 。 第 见 的 情形 是 将 用 户 重 定 回 到 他 可 以 得 入 电子 邮件 
地 址 的 页 面 ， 比 如 ， 诅 页 面 随后 可 以 通过 Facebook、LinkedIn 或 Twitter 进行 OAuth 认证 。 

需要 提醒 注意 的 是 ， 直 接 将 用 户 定向 到 登录 页 面 并 不 需要 你 编写 身份 验证 科 选 如 : 刁 份 
验证 科 选 句 不 会 改变 你 在 应 用 程序 中 编写 安全 性 代码 的 方式 。 号 份 验证 科 选 器 可 能 只 会 在 你 
需要 对 喘 份 验证 和 授权 的 默认 处 理 进 行 目 定义 时 才 会 派 上 用 场 。 例 如 ， 可 以 创建 一 个 身份 验 
证 筛选 器 ， 根 据 运 行 时 条 件 ， 比 如 URL 中 的 参数 ， 在 运行 中 决定 请 求 是 否 需要 号 份 验 证 。 

[AttributeUsage (AttributeTargets.Class | AttrlIbuteTardets .Method ， 
Inherited = true}l] 


public class OptionalAuthenticationAttribute : FilterAttribute, 
IAuthenticationFilter 


{ 
public void OnAuthentication (AuthenticationContext filterContext) 
{ 
Var page = filterCcontext.ActionDescriptor.ActionName; 
1f (CheckYourRuntimeCondition ()) 


{ 
filterContext.Result = new HttpUnauthorizedResult (); 
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return; 
} 
else 
{ 
} 
} 


public vold OnAuthenticationChallenge (AuthenticationChallengeContext 
filterContext) 
{ 
} 
} 
作为 替代 方式 ， 可 以 用 OnAuthenticationChallenge 将 用 户 重 定向 到 男 一 个 他 可 以 提供 额 
外 数据 或 通过 另 一 种 安全 级 别 检查 的 页 面 。 


快速 浏览 Windows 身份 验证 

尽管 Forms 认证 是 迄今 为 止 用 于 ASPNET 应 用 程序 的 最 第 见 的 身份 验证 机 制 ， 但 仍然 
存在 一 些 情形 你 希望 选择 Windows 身份 验证 。 通 稼 情况 下 ， 在 内 网 方案 中 ， 如 有 果 应 用 程序 用 
户 也 有 了 可 以 由 Web 服务 器 进行 身份 验证 的 Windows 账户 时 ， 就 可 以 使 用 Windows 身份 验 
证 方法 。 

当 使 用 Windows 身份 验证 时 ，ASPNET 与 IS 会 同时 工作 。 真 正 的 身份 验证 是 由 IIS 来 
执行 的 ， 它 会 使 用 两 种 ed -种 : 基本 身份 验证 或 集成 Windows 喘 份 验证 。 在 


IIS 验证 了 用 户 身份 后 ， 它 会 将 安全 令 牌 传递 给 ASPNET。 当 配置 为 在 Windows 身份 验证 模 
式 下 运行 时 ，ASPNET 庆 不 二 执 村 相亲 浊 - 步 的 身份 验证 步骤 ， 只 是 使 用 ITS 令 牌 来 授权 对 
资源 的 访问 。 

例如 ， 我 们 假设 你 把 Web 服务 器 配置 为 使 用 集成 Windows 喘 份 验证 模式 ， 并 关闭 匿名 
访问 。 当 用 户 连接 到 ASPNET 应 用 程序 时 会 发生 什么 ? ? 如 果 本 地 用 户 的 账户 不 能 与 Web 服 
务 器 上 的 或 受信 任 域 中 的 账户 相 匹 配 ， 那 么 IIS 就 会 显示 一 个 对 话 框 ， 要 求 用 户 输入 有 效 的 
凭据 。 接 着 ， 如 果 和 凭据 被 认定 为 有 效 ，IIS- 会 生成 个 安全 令 牌 并 交付 给 ASPNET。 


6.2 ”实现 成 员 人 资格 系统 

要 对 用 户 进 行 身份 验证 ， 你 需要 某 种 成 员 资 格 系 统 来 提供 一 些 管理 用 户 账户 的 方法 。 建 
立成 员 资 格 系统 意味 着 编写 用 于 创建 新 用 户 以 及 更 新 或 删除 现 有 用 户 的 软件 和 用 户 界 面 。 同 
时 意味 着 编写 用 于 编辑 用 户 相 关 信 息 的 软件 ， 比 如 用 户 的 电子 邮件 地 址 、 密 码 和 角色 。 
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如 何 创 建 一 个 有 用户? 通常 情况 是 在 某 些 数据 存储 区 添加 新 记录 。 每 个 数据 存储 区 可 以 有 
自己 的 属性 集 ， 但 核心 任务 是 一 样 的 ， 且 很 大 程度 上 由 ASPNET 本 地 成 员 API 来 提取 。 在 
ASPNET MVC 中 ， 你 要 构建 一 个 成 员 资格 系统 ， 将 ASPNET 成 员 API 与 一 个 或 两 个 特定 账 
户 控 制 器 相 结 合 。 一 大 堆 的 视图 和 视图 模型 类 组 成 了 该 基础 架构 。 


注意 : 

用 于 ASPNETMVC 的 微软 Visual Studio 工具 会 生成 一 个 完全 支持 身份 验证 和 授权 的 示 
例 应 用 程序 。 虽 然 它 十 分 实用 ， 但 你 得 到 的 示例 代码 并 不 完全 是 软件 的 优势 典范 。 在 所 有 我 
自己 的 重要 应 用 程序 中 ， 我 会 直接 清除 自动 生成 的 所 有 文件 并 从 头 开 始 构建 ， 这 是 采用 接 下 
来 介绍 的 方法 达成 的 。 


6.2.1 定义 成 员 资 格 控制 器 


最 起 码 ， 需 要 有 一 个 获知 用 户 登 录 和 登 出 的 控制 器 。 下 面 的 示例 AuthController 类 显示 
了 获得 这 种 控制 器 的 一 个 可 能 途径 。 下 面 的 代码 重 现 了 由 ASPNET MVC 的 Visual Studio 工 
上 有 具 所 创建 的 AccountController 关 : 


public class AuthController : Controller 
{ 
[HttpGet] 
public ActionResult Logon () 
{ 
// Just displays the login view 
return View(); 


} 


[HttpPost] 
public ActionResult Logon (LogonViewModel model, String returnUr]l) 
{ 

// Gets posted credentials and proceeds with 

// actual validation 


} 


public ActionResult Logoff (string defaultAction="Index", 
string defaultController="Home") 
{ 
// Logs out and redirects to the home page 
FormsAuthentication.SsSignout(); 
return RedirectToAction (defaultAction, defaultController); 
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Logon 方法 必须 分 成 两 部 分 : 一 部 分 重 载 仅 显 示 登 录 视 图 ， 画 一 部 分 处 理 提 区 的 凭据 ， 
并 继续 进行 实际 的 验证 。Logoff 方法 会 实现 从 应 用 程序 中 登 出 ， 并 重 定 同 到 指定 的 页 和 面 一 一 
通常 是 应 用 程序 的 首页 。 要 登 出 需要 使 用 ASPNET 的 本 地 表单 身份 验证 服务 。 此 外 ， 你 还 可 
以 考虑 为 Logo 企 添加 以 下 重 载 : 
Public ActionResult Logoff (String defaultRoute) 
{ 
FormsAuthentication.SignOut (); 


return RedirectToRoute (defaultRoute); 


} 
该 方法 会 接受 一 个 路 由 名 称 而 非 控 制 器 /操作 对 以 识别 返回 的 URL。 
1. 验证 用 户 凭据 


图 6-1 显示 了 一 个 登录 视图 的 标准 UI。 它 包含 两 个 文本 框 : 用 于 填写 用 户 名 和 密码 ， 以 
及 一 个 复 选 框 ， 询 问 用 户 是 否 硕 望 网 站 记 住 这 些 信 息 。 


| 三 EE http://localhost3595/Auth/Logon 


Sea ，，，， “ 困 


Secured app 


Log On 


Please enter your user name and password. Register if you don't 
have an account, 

Account Information 

User name 


Password 


LDL] Remember me? 


图 6-1 标准 登录 视图 
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下 和 面 是 对 从 该 表单 所 提交 的 数据 进行 处 理 的 控制 器 方法 的 可 能 实现 : 


[HttpPostl] 
public ActionResult LogOon (LogonViewModel model, String returnUrl, 
String defaultAction="Index", String defaultController="Home") 


{ 
var lsValidReturnUrl = IsValidReturnUrl (returnUrl).; 
1f (IModelSstate.IsValid) 
{ 
Modelstate.AddModelError("™", "The user name or password provided 15s 
i1ncorrect,."): 
return View (model); 
} 
// Validate and proceed 
if (Membership.ValidateUser (model .UserName, model .Password)) 
{ 
FormsAuthentication.SetAuthCookie (model .UserName ， 
model .RememberMe).; 
1f (i1sValidReturnUrl]l) 
{ 
return Redirect (returnUr]l).: 
} 
else 
{ 
return RedirectToAction (defaultAction, defaultController); 
} 
} 
// If we got this far, something failed; redisplay form. 
return View (model); 
} 


第 4 草 “ 输 入 表单 ”阐释 过 ， 输 入 数据 可 以 在 一 个 易于 使 用 的 数据 结构 中 收集 并 在 服务 
器 上 人 处理。 这 也 是 你 要 用 LogonViewModel 关 所 做 的 。returnUrl 参数 只 有 在 原始 请 求 慨 重 定 
癌 到 登录 视图 时 才 会 进行 设置 ， 因 为 用 户 需 要 先进 行 届 份 验 证 。 在 这 种 情况 下 ， 重 定向 的 啊 
应 包含 位 置 标 头 中 的 新 URL， 该 URL 包含 一 个 returnUrl 查询 字符 串 参数 。 

验证 是 通过 ASPNET 成 员 API 发 生 的 。 如 果 验 证 成 功 ， 一 个 有 效 的 身份 验证 cookie 便 


通过 FormsAuthentication 类 创建 了 。 接 着， 用 户 会 被 重 定 回 到 最 初 请 求 的 页 面 或 者 首页 。 


2. 集成 成 员 资 格 API 


围绕 Membership 静态 类 ，ASPNET 成 员 资 格 API 使 你 远离 了 如 何 检索 和 比较 和 凭据 及 其 


第 6 章 应 用 程序 安全 性 


他 用 户 信 息 的 细节 。Membership 类 不 直接 包含 其 公 ; 
件 来 提供 。 

在 配置 文件 中 选择 成 员 资 格 。ASPNET 附带 了 几 个 预定 义 的 提供 程序 ， 这 些 提供 程序 面 
问 的 是 微软 SQL Server Express 和 活动 目录 中 的 MDF 文件 。 但 是 ， 你 最 终 创建 自己 的 成 员 资 
格 提 供 程序 也 不 是 不 寻 第 的 情况 ， 所 以 可 以 重复 使 用 现 有 的 用 户 数 据 存 储 区 ， 并 完整 控制 数 
据 存储 区 的 结构 。 

定义 自 定义 的 成 员 资格 提供 程序 一 点 也 不 难 。 你 只 需要 从 MembershipProvider 派生 一 个 
新 类 并 重 写 所 有 的 抽象 方法 。 最 起 码 要 重 写 ValidateUser 、GetUser 、 CreateUser 和 
ChangePassword 等 几 个 方法 。 


己 。 实 际 的 逻辑 由 提供 程 订 组 


public class PoorManMembershipProvider : MembershipProvider 


{ 

public override bool ValidateUser (String username, String password) 

{ 

} 

public override MembershipUser GetUser (String username, Boolean 

userIsonline) 

{ 

} 

public override MembershipUser CreateUser (String username, String password, 
String email, String passwordQuestion, String passwordAnswer, 
Boolean 1isApproved, Object providerUserKey, 
out MembershipCreatestatus status) 

{ 

} 

public override Boolean ChangePassword (Strlnd username, String oldPassword, 

String newPassword) 

{ 

} 

// Remalnder of the MembershipProvider interface 

} 
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尤其 是 ， 在 ValidateUser 的 实现 中 ， 要 提取 出 用 户 名 称 和 密码 ， 并 将 它们 与 你 的 数据 库 
进行 核对 。 作 为 一 种 安全 措施 ， 建 议 你 以 哈 希 格式 存储 密码 。 下 面 是 一 个 将 输入 密码 与 存储 
的 哈 希 密码 进行 核对 的 快速 演示 : 

public override bool ValidateUser (String username, String password) 

{ 


// Validate user name 


// Runs a query against the data store to retrieve the 

// password for the specified user. We're assuming that 七 he 
// retrieved password 15 hashed. 

var storedPassword = GetStoredPasswordForUser (username).; 


// No user found 
1f (storedPassword == null) 
return false-: 


// Hash the provided password and see 1f that matches the stored password 
var hashedPassword = Utils.HashPassword (password); 
return hashedPassword == storedPassword; 


默认 的 成 只 资格 API 由 于 其 繁琐 而 备 受 指责 ， 且 明显 违反 接口 隔离 原则 一 一 也 就 是 流行 
的 SOLID 首 字 和 母 缩 写 中 的 “I” 原 则 (SOLID 表示 单 -功能 、 开 闭 原 则 、 里 氏 蔡 换 、 接 口 隔离 
以 及 依赖 反 转 )。 成 员 资 格 API 试图 和 窗 新 合理 数量 的 不 同情 形 , 但 近来 对 于 大 部 分 第 见 的 情形 
来 说 ， 可 能 过 于 复杂 和 丰富 。 创 建 自 定义 的 成 员 资 格 提 供 程 序 有 助 于 解决 这 个 问题 ， 但 并 不 
能 完全 解决 ， 因 为 它 只 会 构建 -个 简单 的 外 观 。 


3. 使 用 SimpleMembership API 


如 果 不 想 从 头 开 始 创 建 目 己 的 成 员 资 格 层 , 可 以 笃 试 为 一 种 由 SimpleMembership API 所 
表示 的 折 中 方法 选项 ， 它 最 早 用 于 ASPNET Web 页 面 。 

SimpleMembership API 只 是 在 ASPNET 成 员 资 格 API 和 数据 存储 区 上 的 封 冯 而已。 有 了 
它 ， 驶 可 以 使 用 任何 己 有 的 数据 存储 区 ， 并 且 它 只 要 求 你 指明 哪些 列 作为 用 户 名 和 用 户 JD。 
WebSecurity 类 提供 了 一 个 简化 的 API， 用 它 可 以 做 你 的 成 员 资格 琐事 ， 其 与 经 典 的 成 员 资 格 
API 的 主要 区 别 是 从 根本 上 缩短 了 各 个 方法 的 参数 列表 ， 并 且 对 存储 架构 来 说 ， 有 了 更 大 的 
自由 度 。 下 面 的 代码 显示 了 如 何 创建 一 个 新 用 户 : 


WebSecurity.CreateUserAndAccount (username, password, 
new{ FirstName = fname, LastName = lname, Emalill = emall }); 
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其 结果 是 ， 直 到 ASPNET MVC 4 的 出 现 ， 你 才 有 了 两 条 平行 的 路 由 用 于 成 员 资 格 的 实现 ， 
分 别 为 : 围绕 MembershipProvider 类 的 经 典 成 员 资 格 API 以 及 围绕 ExtendedMembershipProvider 
类 的 简单 成 员 资 格 API。 这 两 个 API 并 不 兼容 。 在 ASPNET MVC 5 中 便 努 力 把 这 些 成 员 资 
格 实现 经 验 结合 起 来 。 但 是 这 需要 添加 男 一 个 API 一 一 ASPNET 身份 。 后 面 会 介绍 ASPNET 
身份 。 


4. 集成 角色 API 


ASPNET 中 的 角色 简化 了 需要 授权 的 应 用 程序 的 实现 。 角色 就 是 分 配给 用 户 的 一 个 逻辑 
特性 。 ASPNET 角色 是 一 个 普通 字符 串 , 指 的 是 用 户 在 应 用 程序 上 下 文中 所 扮演 的 逻辑 角色 。 
从 配置 方面 来 说 ， 每 个 用 户 可 以 分 本 到 -个 或 多 个 角色 。ASPNET 查找 当前 用 户 的 角色 ， 并 
将 这 些 信 息 绑 定 到 User 对 象 ASPNET 用 一 个 角色 提供 程序 组 件 来 管理 给 定 用 户 的 角色 信息 。 

角色 提供 程序 是 继承 自 RoleProvider 类 的 一 个 类 。 和 角色 提供 程序 的 架构 与 成 员 资 格 提供 
程序 的 染 构 没有 多 大 区 别 ， 并 且 有 着 相 同 的 复杂 性 问题 。 要 使 事情 变 得 简单 或 封 淡 现 有 的 数 
据 存 储 区 ， 你 可 能 会 希望 创建 一 个 自 定义 的 角色 所 供 程序 ， 或 切换 到 简单 的 角色 API， 也 就 
是 简单 成 员 资 格 API 的 角色 对 应 项 。 

下 面 的 代码 片段 显示 了 如 何以 编程 方式 将 角色 和 用 户 相 关联 。 需 要 使 用 Roles 类 ， 作 用 
于 有 具体 的 角色 提供 程序 。 

// Create Admin role 


Roles.CreateRole ("Admin™); 
Roles.AddUsersToRole ("DinoE™, "Admin™); 


// Create Guest role 
Roles.CreateRole ("Guest"),;) 

Var guests = new String[2]; 

guests[0] = "Joe"™; 

guests[1] = "Godzilla"; 
Roles.AddUsersToRole (guests, "Guest") 


在 运行 时 , 已 登录 的 用 户 信息 可 通过 HTTP 上 下 文 的 User 对 象 获得 。 下 面 的 代码 揭示 了 
如 何 确定 当前 用 户 是 人 否 属于 茶 一 角色 并 随后 局 用 特定 功能 


1f (User.IsInRole ("Admin™)) 
| 


// Enable functions specific to the role 
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5. ASP.NET 身份 


且 份 验证 的 目的 是 获取 与 当前 用 户 关 联 的 身份 。 检 索 身 份 以 将 所 提供 的 凭据 与 存储 在 数 
据 库 中 的 记录 相 匹 配 。 随 后 ， 喘 份 系统 会 基于 两 个 主要 区 块 : 用 户 喘 份 验证 管理 器 和 存储 管 
新 的 ASPNET 身份 系统 是 Visual Studio 2013 所 预示 的 进行 Web 开发 的 “One ASPNET” 
方法 的 产物 ， 预 计 会 成 为 所 有 ASPNET 应 用 程序 处 理 用 户 喘 份 验 证 的 首选 方法 ， 无 论 是 基 
于 Web Forms 还 是 MVC。ASPNET 里 份 的 主要 目的 一 一 Visual Studio 2013 和 ASPNET MVC 
5 中 验证 用 户 号 份 的 标准 方法 一 一 是 通过 把 整个 系统 分 解 为 两 个 关键 的 组 件 并 使 用 依赖 性 注 
eh 合 ， 以 统一 身份 验证 的 方法 。 
在 ASPNET 身份 框架 中 ， 喘 份 验证 管理 器 采用 了 UserManager <TUser> 类 的 形式 。 该 类 
大 体 上 提供 了 一 个 用 于 用 户 登 录 和 登 出 的 外 观 。UserManager 类 声明 如 下 : 


public class UserManager<TUser> : IDisposable where TUser : JIUser 


{ 
} 


TUser 类 型 指 的 是 要 管理 的 用 户 的 当前 描述 。IUser 接口 包含 一 个 对 用 户 的 最 低 限 度 的 定 
义 ， 限 于 ID 和 名 称 。ASPNET 身份 API 定义 了 实现 IUser 接口 和 添加 一 些 额外 属性 的 
IdentityUser 类 型 。 


public class IdentityUser : IUser 
{ 
public string Id { get; } 
public string UserName { get; set; } 
public string PasswordHash { get; set; } 
public string SecuritySstamp { get; set; } 
public ICollection<IdentityUserRole> Roles { get; private set; } 
public ICollection<IdentityUserClaim> Claims { get; private set; } 
public ICollection<IdentityUserLogin> Logins { get; private set; } 
} 


从 Visual Studio 2013 向 导 处 获得 的 ASPNET MVC 5 示例 应 用 程序 同样 以 继承 自 
IdentityUser 的 ApplicationUser 类 为 特征 ， 并 为 进一步 的 扩 展 做 好 了 准备 。 可 以 通过 在 下 面 的 
类 中 添加 更 多 的 属性 ， 为 应 用 程序 要 处 理 的 用 户 轻松 地 添加 额外 的 配置 文件 数据 : 


Public class ApplicationUser : IdentityUser 
{ 
} 
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用 于 用 户 存 储 的 核心 类 是 UserStore <TUser>。TUser 类 型 必须 是 IdentityUser 或 进一步 
继承 的 类 ， 如 ApplicationUser。 用 户 存储 类 实现 了 IUserStore 接口 ， 它 汇总 了 在 用 户 存储 区 
允许 执行 的 操作 。 


public interface IUserSstore<TUser> : IDisposable where TUser : IUser 
{ 

Task CreateAsync (TUser USeTr) :; 

Task DeleteAsync (TUser USeTr) :; 

Task<TUser> FindBylIdAsync (string userId); 

Task<TUser> FindByNameAsync (string userName); 

Task UpdateAsync (TUser USeTr) ; 

} 

可 以 看 出 ， 用 户 存 储 接口 看 起 来 很 像 你 围绕 数据 访问 层 所 构建 的 典型 的 存储 库 接 口 。 
UserManager <TUser> 和 UserStore <TUser> 类 存在 于 不 同 的 名 称 空间 和 程序 集 里 。 具 体 来 说 ， 
UserManager 人 存在 于 Microsoft.AspNet.Identity.Core 中 ,| 向 UserStore 在 Microsoft.AspNet.Identity. 
EntityFramework 中 定义 并 与 实际 的 存储 技术 有 着 某 种 相关 性 。 

整个 基础 架构 在 账户 控制 器 类 中 密切 地 联系 在 一 起 。 下 面 是 一 个 ASPNET MVC 账户 控 
制 如 类 的 框架 ， 它 完全 基于 ASPNET 有 身份 API: 

Public class AccountController : Controller 

{ 

public UserManager<ApplicationUser> UserManager { get; set; } 
public AccountController (UserManager<ApplicationUser> manager) 
{ 

UserManager = manager; 
} 


public Accountcontroller() : thls( 
new UserManager<ApplicationUser> (new UserSsStore<ApplicationUsery> (new 
ApplicationDbContext ()))) 
{ 
} 


该 控制 嚣 会 保留 住 对 身份 验证 标识 管理 器 的 引用 。 和 号 份 验证 标识 管理 器 的 一 个 实例 是 被 
注入 到 控制 器 中 。 
身份 存储 区 会 被 注入 到 标识 管理 器 中 ， 用 来 验证 凭据 。 但 身份 存储 区 需要 获知 实际 的 数 
据 源 。 用 户 数据 通过 实体 框架 代码 优先 (Entity Framework Code First) 进 行 管 理 。 这 意味 着 你 不 
- 定 需 要 创建 一 个 物理 的 数据 库 来 存储 你 的 用 户 赁 据 ; 相反 ， 可 以 定义 一 个 ApplicationUser 
类 ， 用 基本 框架 创建 一 个 最 合适 的 数据 库 来 存储 这 些 记 录 。 用 户 存 储 区 和 数据 存储 区 之 间 的 
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联系 是 建立 在 癌 导 为 你 创建 的 ApplicationDbContext 类 中 的 。 


public class ApplicationDbContext : IdentityDbContext<ApplicationUser> 


{ 
public ApplicationDbContext() : base("DefaultConnection"™) 
{ 

} 


IdentityDbContext 基 类 继承 自 DbContext， 并 依赖 于 实体 框架 。 正 是 从 构造 函数 中 ， 你 会 
发 现 该 类 指 的 是 web.config 文件 中 用 于 读 取 的 表示 实际 连接 字符 串 的 条 目 。 

实体 框架 代码 优先 的 使 用 是 一 重大 举措 ， 因 为 它 使 数据 库 的 结构 成 为 一 个 次 要 重点 。 你 
仍然 需要 它 ， 但 可 以 用 代码 创建 一 个 基于 类 的 数据 库 结 构 。 此 外 ， 可 以 使 用 实体 框架 代码 优 
先 迁 移 工具 修改 以 前 创建 的 数据 库 ， 就 像 你 修改 其 背后 的 类 一 样 (参见 http://msdn.microsoft. 
com/data/]]391621.aspx) 


6. 使 用 ASP.NET 身份 对 用 户 进 行 验证 


ASPNET 身份 也 是 基于 最 新 的 用 于 NET(OWIN) 身 份 验证 中 间 件 的 Open Web 接口 .这 意 
味 着 进行 身份 验证 (cookies 检查 和 创建 ) 的 典型 步骤 可 以 通过 抽象 的 OWIN 接口 来 执行 ,而 不 
是 直接 在 ASPNET/IIS 接口 中 执行 。 对 OWIN 的 支持 需要 账户 控制 器 具有 另 一 个 易 用 属性 ， 
如 下 所 示 : 


private IAuthenticationManager AuthenticationManager 
{ 
get { 
return HttpContext .GetOwinContext () .Authentication; 
} 
} 


IAuthenticationManager 接口 是 在 Microsoft.Owin.Security 名 称 空间 中 定义 的 。 此 属性 非 
常 关 键 ， 因 为 它 需 要 被 注入 到 包括 身份 验证 相关 步 又 的 所 有 操作 中 。 让 我 们 来 看 一 个 典型 的 


private async Task SignInAsync (ApplicationUser user, bool isPersistent) 


{ 
AuthenticationManager.SignOout (DefaultAuthenticationTypes .ExternalCooklie); 
Var lidentity = awalt UserManader .CreateIdent1ltyasync (user., 
DefaultAuthenticationTypes.ApplicationCookie); 
AuthenticationManager.signInl 
new AuthenticationProperties() { IsPersistent =1isPersistent }, identity); 
} 
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要 注册 一 个 新 用 户 ， 需 要 以 下 代码 : 


Var user = new ApplicationUser() { UserName = model.UserName }; 


Var result = awalt UserManager.CreateAsync (user, model.Password); 
1f (result.SsSucceeded) 
{ 


awalt SignIinAsync (user, lsPersilstent: false); 
return RedirectToAction ("Index™", "Home™); 


} 


总 而 言 之 ，ASPNET 身份 为 大 部 分 与 身份 验证 相关 的 任务 提供 了 一 个 统一 的 API。 就 个 
人 而 言 ， 我 喜欢 这 个 API 的 表现 力 以 及 将 不 同形 式 的 身份 验证 融合 在 一 起 的 党 试 一 一 比如 内 
置 和 基于 OAuth。 另 一 个 很 大 的 加 分 是 与 OWIN 的 结合 ， 使 其 在 某 种 程度 上 独立 于 
IIS/ASPNET 这 种 特定 的 运行 时 。 无 论 你 是 否 在 当前 项 目 中 使 用 它 ， 都 绝对 应 该 了 解 一 下 
ASPNET 身份 。 


6.2.2 记 住 我 (Remember-Me) 特 性 与 Ajax 


如 今 ， 几 乎 所 有 的 登录 视图 都 标记 着 “ 记 住 我 ”或 “保持 登录 状态 ”的 复 选 杠 ， 就 像 
Facebook 那样 。 通 常 选 择 该 复 选 框 会 使 身份 验证 cookie 保持 更 长 的 时 间 ; 更 长 是 多 长 取决 于 
页 面 背 后 的 代码 。 标 记 仅 表明 获得 更 为 持久 cookie 的 用 户 偏好 ， 以 使 他 保持 连接 到 站 点 的 时 
则 更 长 ， 而 不 用 壬 次 单 新 键入 先 据 。 

如 果 该 cookie 过 期 , 在 用 户 下 次 访问 时 将 被 自动 重 定 同 到 登录 页 面 并 请 求 用 户 重 新 输入 
用 户 名 和 密码 。 这 种 模式 并 不 新 坷 ， 而 且 开 发 人 员 也 已 经 习惯 了 。 但 在 Ajax 方案 中 该 模式 可 
能 会 带 来 一 些 问 题 。 


1. 重 现 问题 


想象 一 下 用 户 单 击 某 处 并 向 服务 器 发 出 一 个 Ajax 调用 的 情形 。 再 假设 身份 验证 cookie 
己 经 过 期 。 随 后 ， 服 务 器 会 返回 一 个 HITP 302 状态 码 ， 将 用 户 重 定 癌 到 登录 页 面 。 这 就 是 
大 家 所 期 望 的 ， 不 是 吗 ? 那么 问题 在 哪里 呢 ? 

在 Ajax 方案 中 ， 处 理 请 求 的 是 XMLHttpRequest 对 象 ， 而 不 是 浏览 器 。XMLHttpRequest 
会 正确 处 理 重 定向 ， 并 转 到 登录 页 。 但 是 ，Ajax 调用 的 原始 发 出 者 会 重新 获得 登录 页 面 的 标 
记 而 非 大 家 预期 的 数据 。 其 结果 是 ， 登 录 页 面 很 可 能 会 被 插入 到 原始 咽 应 预期 会 插入 的 任意 
DOM 位 置 ， 如 图 6-2 中 所 示 。 
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This application doesn't really allow you to 


do much without logging in! 


6-2 注入 登录 视图 的 对 受 限 URL 的 Ajax 请 求 
2. 解决 问题 


要 变通 解决 这 一 问题 ， 必 须 在 授权 阶段 拦截 该 请 求 并 验证 它 是 否 是 Alax 请 求 。 如 果 是 
Ajax 请 求 且 该 请 求 被 拒绝 ， 那 么 你 要 连接 到 状态 代码 ， 将 其 更 改 为 401。 之 后 你 所 拥有 的 客 
户 端 脚本 将 其 纳入 运算 ， 并 显示 适当 的 HIML， 如 下 所 示 : 


<script type="text/Javascript"> 
function failed (xhr, textstatus, errorThrown) { 
1f (textSstatus == "error™) ff 
1f (xhr.status === 401) I 
$s ("#divoutput"™") .html ("You must be logged 1in."™); 
} 
} 
} 
</script> 


失败 的 JavaScript 图 数 是 在 表单 提交 失败 或 链接 请 求 失败 时 Alax 基础 架构 使 用 的 回调 (如 
第 4 章 中 所 介绍 的 )。 下 面 是 用 于 图 6-2 中 所 示 表 单 的 代码 : 
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Qusing (AjJax.BeginForm("Now", "Homen" ， 
new AjaxOoptions { UpdateTardetId = "divOoutput", OnFalilure="failed"™ })) 


<input type="submit"™ value="What 七 Ime 1is it?"™ /> 
} 
<hr /> 
<dliv 1id="divoutput"> 
</div> 


真正 的 工作 是 由 Authorize 特性 的 稍 作 修订 的 版 本 来 完成 的 。 总 体 来 说 ， 可 以 直接 扩展 
AuthorizedOnly 特性 ， 像 下 面 所 示 的 那样 ， 并 在 所 有 有 必要 限制 访问 某 方法 的 情况 下 使 用 它 。 
用 下 面 这 个 来 替换 以 前 实现 的 CheckIfUserIs Authenticated 内 部 方法 : 


private void CheckIfUserIsAuthenticated (AuthorizationContext filterContext) 
| 
// If Result 1s null, we're OK 
1f (filterContext.Result == null) 
return; 


// Is this an Ajax request? 
1if (filterContext.HttpContext.Request.IsAJjaxRequest () ) 


// For an Ajax request, Just end the request 
filtercontext .HttpContext .Response.statusCode = 401; 
filterCcontext .HttpContext .Response.End(); 


// If here, you're getting an HTTP 401 status code 
if (filterContext.HttpContext.User.Identity.IsAuthenticated) 


Var result = new ViewResult {ViewName = View, MasterName = Master}; 
filterContext.Result = result; 


} 


有 了 最 后 这 个 更 新 ，AuthorizedOnly 特性 就 可 以 成 为 系统 Authorize 特性 的 最 终 蔡 代 品 。 
下 面 是 一 个 可 以 通过 Ajax 和 常规 提交 进行 调用 的 限制 级 控制 器 方法 示例 。 图 6-3 显示 了 预期 
的 效果 。 


[AuthorizedOonlyl] 
public ActionResult Now() 
{ 
ViewBag.Now = DateTime.Now.ToString ("hh:mm:ss"); 
if (Redquest .IsSA]axReduest () ) 
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return PartialView ("aNOw"):; 
return View():; 


} 
} 
This application doesn't really allow you to 
do much without logging in! 
You must be logged in. 
6-3 ”在 Ajax 请 求 的 情况 下 不 会 显示 登录 视图 
注意 : 


“ 记 住 我 ”这 个 问题 只 有 当 你 使 用 Ajax.BeginForm( 或 部 分 呈现 ) 时 会 体现 出 来 。 如 果 正 
在 对 HTTP 端点 进行 直接 调用 并 根据 你 得 到 的 响应 更 新 用 户 界 面 ， 那 么 一 切 就 都 在 你 的 控制 
之 下 。 此 外 ， 如 果 正 调用 一 个 返回 JavaScript 对 象 标记 (JSON) 而 非 HTML 的 端点 ， 那 么 你 会 
有 更 多 机 会 去 深入 理解 其 响应 并 做 出 相应 的 处 理 。 


6.3 外 部 身份 验证 服务 


在 网 站 中 实现 目 己 的 号 份 验证 层 绝对 是 一 种 选择 。 然 而 ， 近 来 它 变 成 了 只 是 一 种 选择 而 
己 ， 甚 全 可 能 不 是 最 令 用 户 信服 的 选择 。 通 过 实现 你 目 己 的 导 份 验证 层 ， 就 可 以 目 己 负责 安 
全 存储 密码 ， 并 让 你 的 团队 负责 完成 充分 管理 账户 的 额外 工作 。 从 用 户 的 角度 来 看 ， 他 们 感 
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兴趣 的 任何 新 网 站 似乎 都 会 加 列表 中 添加 新 的 用 望 名 称 /密码 配对 。 对 于 用 户 来 说 ， 怎 记 密 码 
真 的 很 麻烦 。 

儿 年 前 ， 微 软 刚 推出 的 Passport 方案 是 一 个 当 用 户 横路 几 个 相关 网 站 时 为 其 身份 提供 便 
利 的 早期 尝试 。 有 了 Passport， 用 户 只 需要 登录 一 次 ， 如 果 他 们 成 功 通过 喘 份 验证 ， 便 可 以 
在 所 有 相关 联 的 网 站 上 进行 目 由 浏览。 

Passport 方案 及 其 相关 的 API, 现 在 被 官方 淘汰 了 ,因为 它 己 经 被 OpenID (http://openid.net) 
所 取代 。 对 于 依赖 流量 和 大 众 的 网 站 来 说 ，OpenID 身份 验证 是 一 个 利益 依 关 的 登录 特性 , 真 
正 有 助 于 吸引 和 留 住 更 多 来 到 网 站 的 访问 者 。 


6.3.1 OpenlD 协议 


OpenID 的 主要 目的 是 为 了 使 网 站 访问 更 简单 、 快 捷 ， 尤 其 是 不 要 让 最 终 用 户 感到 麻烦 。 
任何 支持 OpenID 的 网 站 的 访问 者 都 可 以 使 用 另 一 个 网 站 所 发 出 的 已 有 喘 份 令 牌 来 登录 。 已 
启用 OpenID 的 网 站 会 针对 已 有 的 (外 部 ) 号 份 提供 程序 为 用 户 进行 身份 验证 , 并 且 不 需要 存储 
密码 和 实现 成 员 资格 层 。 

虽然 提供 了 标准 ， 但 特定 站 点 的 成 员 资 格 解决 方案 仍然 是 一 个 选项 ， 很 多 网 站 现在 还 可 
以 让 访问 者 使 用 从 某 些 提供 程序 收 到 的 OpenID 进行 身份 验证 。 这 一 OpenID 与 表单 验证 或 身 
份 验证 并 不 会 相互 排斥 。 

6-4 提供 了 一 个 由 文 持 OpenID 的 网 站 所 采用 的 号 份 验 证 人 逻辑 的 全 貌 图 。 当 用 户 用 一 
个 受 文 持 的 OpenID 点 击 登 录 时 ， 网 站 便 会 连接 到 指定 的 提供 程序 ， 并 获得 该 用 户 的 访问 令 
牌 。 可 能 会 要 求 该 用 户 输入 OpenID 提供 者 站 点 的 凭据。 已 经 用 提供 程序 登录 的 用 户 也 会 目 
动 登录 到 用 户 感 兴趣 的 网 站 。 在 这 种 情况 下 , 的 层 发 生 的 这 几 个 重 定 疝 绝 不 会 显示 中 间 页 面 ， 
感觉 就 与 在 同一 个 应 用 程序 的 两 个 页 面 之 间 转 换 一 样 平滑 。 


OpenID URL 


图 6-4 使 用 OpenDD 的 喘 份 验 证 


你 的 网 站 不 一 定 非得 是 OpenID 的 身份 提供 者 ， 但 却 很 容易 成 为 如 今 少 数 几 个 可 用 的 
OpenID 提供 者 所 提供 的 号 份 令 牌 的 使 用 者 。 和 雅虎、Flickr 和 谷歌 都 是 流行 的 OpenID 提供 者 。 
总 体 来 看 ，OpenID 与 原本 的 Windows Live ID 并 没有 什么 人 不同， 差别 仅 在 于 它 依 赖 奎 干 服务 
提供 者 ， 且 不 会 强制 人 们 从 特定 的 提供 者 那里 获取 男 一 个 账户 。 通 过 支持 OpenID， 你 的 用 户 
就 可 以 使 用 他 们 已 经 有 的 任何 和 凭据 登录 到 你 的 网 站 上 。 用 户 可 以 从 实质 上 选择 他 们 从 何 处 
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登录 。 
1. 通过 OpenlD 提供 者 标识 用 户 


有 不 少 程序 库 会 帮助 把 OpenID 集成 到 网 站 。 在 .NET 开发 人 员 间 流行 的 一 个 就 是 
DotNetOpenAuth(DNOA)， 可 以 从 http:/www.dotnetopenauth.net 处 获得 。 6-5 显示 了 一 个 
使 用 DNOA 库 对 用 户 提 供 的 任何 有 效 OpenID URL 执行 身份 验证 的 示例 应 用 程序 。 


区- > Pe http://localhost22809/auth/logon?ReturnUrl= 32fHormme3eofMembersOnly 


图 6-5 连接 到 你 可 能 知晓 的 任意 OpenID 提供 者 的 应 用 程序 示例 


作为 开发 人 员 ， 你 要 抓 住 的 第 一 条 信息 就 是 你 准备 文 持 的 服务 (或 多 项 服务 ) 的 OpenID 
URL。 这 个 信息 对 各 个 用 户 来 说 可 能 相同 也 可 能 不 同 。 例 如 ， 人 谷歌 和 雅虎 对 不 同 的 用 户 始终 
使 用 相同 的 URL。 下 面 分 别 是 谷歌 和 雅虎 的 URL: 

@ https:/www.google.com/accounts/o8/1d 

® http://yahoo.com 
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提供 程序 要 在 这 种 情况 下 从 请 求 的 详细 信息 (比如 一 个 cookie) 中 找 出 用 户 的 账户 名 称 来 
进行 号 份 验证 。 如 果 没 有 收集 到 详细 信息 ， 或 者 用 户 当前 未 登录 到 该 服务 ， 则 该 服务 会 显示 
登录 页 面 以 收集 凭据 ， 如 果 一 切 都 没 问 题 ， 则 该 服务 会 重 定 同 回去 (可 能 是 具有 进一步 访问 的 
cookie)。 其 他 的 提供 程序 ， 比 如 myOpenID (http://www.myopenid.com)， 则 要 求 每 个 用 户 有 一 
个 不 同 的 URL。 特 定 于 用 户 的 URL 的 形式 为 http:/name.myopenid.com。 该 服务 会 从 URL 
中 确认 账户 名 称 ， 然 后 按照 前 文 所 示 的 过 程 执行 。 

作为 开发 人 员 ， 如 果 准 备 支 持 使 用 固定 URL 的 OpenID 提供 程序 ， 便 可 以 避免 出 现 如 图 
6-5 中 所 示 的 文本 框 ， 代 之 以 一 个 链接 或 一 个 按钮 。 一 般 情 况 下 ， 你 会 布 望 将 用 户 端 的 输入 
降低 到 最 低 限 度 。 例如 , 对 于 myOpenID, 你 只 需要 输入 URL 的 第 一 部 分 。 下 面 是 用 于 图 6-5 
中 所 示 小 表单 的 HTML: 


Qusing (Html .BeginForm("authenticate", "auth", new { TeturnUr1l = Redquest . 
Querystring["ReturnUrl"] })) 


{ 
<label for="openid identifier">OpenID URL: </label> 
<input id="openid identifier" name="openid identifier" size="40" /><br /> 
@Html .ValidationMessage ("openid identifier") 
<br /> 
<input type="submit™ value="Sign in™ /> 
} 


登录 按钮 会 发 送 如 下 所 示 的 一 个 方法 : 


Public ActionResult Authenticate (String returnUrl, [Bind (Prefix= 
"openid identifier")]Sstring url]l) 

{ 

// First step: lssuing the request and returning here 

Var response = RelyingParty.GetResponse ();，; 

1f (response == null) 

{ 

1f (!'RelyingParty.IsVvalid (url)) 
return View("Logon™); 


try 

{ 
return RelyingParty.CreateRequest (url). 

RedirectingResponse.AsActionResult (); 

} 

catch (ProtocolException ex) 

{ 
Modelstate.AddModelError ("openid identifier", ex.Message); 
return View("LogOon™); 
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} 


// Second step: redirected here by the provider 
switch (response.status) 
{ 
case Authenticationstatus.Authenticated: 
FormsAuthentication.SetAuthCookie (response.ClaimedIdentifier, 


true); 
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return Redirect (returnUr]l). 


case Authenticationstatus .Canceled: 
return View("Logon™); 


case Authenticationstatus .Faliled: 
return View("Logon™); 
} 


return new EmptyResult (); 
} 
在 前 面 的 代码 中 ,该 方法 归属 于 包含 一 个 RelyingParty 属性 的 控制 器 类 ，RelyingParty 属 
性 的 定义 如 下 : 


protected static OpenIdRelyingParty RelyingParty = new OpenIdRel1ylIngqParty (); 


这 个 示例 中 的 控制 器 由 仅 提供 RelyingParty 属性 的 基 类 派生 而 来 。 

OpenIdRelyingParty 类 型 是 在 DNOA 库 中 定义 的 。 和 号 份 验证 在 同一 个 控制 占 方 法 内 分 两 
个 阶段 开发 -CreateRequest 方法 准备 适当 的 HTTP 请 求 并 将 它 与 指定 的 OpenID URL 相关 联 。 
提供 程序 接收 草 定 疝 回 到 相同 URL 和 相同 控制 右 方 法 的 指令 。 不 过 , 这 第 二 次 的 啊 应 就 个 是 
null 六， 可 以 创建 一 个 第 规 的 ASPNET 里 份 验证 cookie， 它 的 用 户 名 称 就 是 由 OpenID 提供 
程序 所 返回 的 账户 名 称 。 

请 注意 在 这 方面 你 是 没有 控制 权 的 一 一 提供 程序 会 决定 返回 什么 样 的 经 过 喘 份 验证 的 用 
户 友 好 名 称 。 例 如 ， 出 于 安全 原因 ， 人 谷歌 不 会 返回 有 重要 含义 的 友好 名 称 ; 
FriendlyIdentifierForDisplay 属性 和 被 设置 成 退 用 的 OpenID URL。 当 你 使 用 myOpenID 时 ， 它 
会 将 啊 应 的 FriendlyIdentifierForDisplay 设置 成 URL， 并 仅仅 删除 模式 信息 和 尾部 斜 枉 。 要 完 
成 与 ASPNET 身份 验证 基础 染 构 的 集成 ,你 需要 创建 一 个 常规 的 时 份 验证 cookie， 让 用 户 名 
显示 在 登录 区 域 中 。 图 6-6 显示 了 通过 myOpenID 提供 程序 的 身份 验证 步骤 。 

6-7 显示 了 用 户 成 功 通 过 myOpenID 号 份 验 证 并 返回 最 初 请 求 站 点 时 所 出 现 的 页 面 。 
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< ll https://www.myopenid.com/signin_password? =4ac7-c492-c861&tid=6adeffl8&xtoke ~ 候 @@| I yf 


(I) Notice 


You must sign in to authenticate to http:/ /localhost:22809/ as http:/ /despos.myopenid.com/ 


Usermame http://despos.myopenid.com/ 


Password [onoono0s 7 


L | stay signed in 


图 6-6 使 用 myOpenID 的 身份 验证 阶段 


GQ © 加 http://localhost:22809/Home/MembersOnbhy 


erben ory ses | 


Welcome despos.myopenid.com! [ Los Off ] 


Ee 


OpenlDiester 


Reserved area 


This view is reserved only to paying members... 


图 6-7 ”使 用 myOpenDD 的 用 户 身 份 验证 
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用 户 名 称 取决 于 你 创建 该 cookie 时 传递 的 第 一 个 参数 (第 二 个 参数 是 你 是 否 需要 一 个 持 
久 性 cookie 来 保持 用 户 的 登录 状态 )。 


FormsAuthentication.SetAuthCookie (response.ClaimedIdentifier, true); 


这 里 可 以 自由 使 用 名 称 。 如 果 仍 然 保有 一 份 特定 于 应 用 程序 的 昵称 列表 的 话 ， 就 可 以 将 
声明 的 标识 符 映射 到 昵称 并 显示 这 个 上 昵称。 或者， 可 以 直接 更 新 UI 来 告知 成 功 登 录 的 用 户 ， 
而 不 用 显示 用 户 名 称 。 还 有 另 一 种 选择 是 创建 一 个 需要 目 定 义 的 身份 验证 cookie， 这 里 你 需 
要 使 用 身份 验证 票据 (cookie 的 实际 内 容 ) 的 UserData 属性 来 持续 存储 要 显示 的 友好 名 称 。 这 
种 方法 的 好 处 是 ， 你 既 保 存 了 声明 的 标识 符 ， 又 保存 了 你 自己 合适 的 友好 名 称 。 下 面 是 一 个 
创建 目 定义 身份 验证 cookie 的 扩展 方法 : 


public delegate String UserNameAdapterDeledate (String userName); 
public static HttpCookie CreateAuthCookie (this IAuthenticationResponse 


response, 
Boolean persistent = true, 
UserNameAdapterDelegate fnAdapter = null) 
{ 
Var USerName = response.ClaimedIdentifier; 
Var userDisplayName = response.FriendlyIdentifierForDisplay; 
1f (fnAdapter != null) 
userDisplayName = fnAdapter (userDisplayName); 


return CreateAuthCookie (userName, userDisplayName, persistent); 


private static HttpCookie CreateAuthCookie (String username, 
String userDisplayName, 
Boolean persistent) 


// Let ASP.NET create a regular authentication cookie 
var Cookie = FormsAuthentication.GetAuthCookie (username, persistent); 


// Modify the cookie to add friendly name 
Var ticket = FormsAuthentication.Decrypt (cookie.Value);} 
Var newTicket = new FormsAuthenticationTicket (ticket .Version, 
ticket.Name, ticket.IssueDate, ticket.Expiration, ticket. 
IsPersistent, userDisplayName); 
cooklie.Value = FormsAuthentication.Encrypt (newTicket);} 


// This modified cooKkle MUST be re-added to the Response.Cookies collection 
return cookie; 
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下 面 是 将 此 扩展 方法 放 入 账户 的 控制 左 中 的 Authenticated 方法 略 作 修改 的 版 本 : 


swltch (response.status,) 
{ 
case AUuthent1lcat1lonstatus .Authent1lcated : 
var Cookie = response.CreateAuthCookie (true, StopAtFirstToken); 
Response.Cookies.Add (cook1ie); 
1f (i1sVvalidReturnUrl) 
return Redirect (returnUrl); 
return RedirectToAction ("Index™"™, "Home™); 


} 


UserNameAdapterDelegate 委托 表示 一 个 函数 的 模板 , 可 以 注入 这 个 函数 以 确定 要 显示 的 


Public String StopAtFirstToken (String name) 
{ 

Var tokens = name.split("'."'); 

return tokens[0]; 


} 
最 后 , 需要 编辑 登录 视图 来 显示 cookie 中 UserData 字段 的 内 容 , 而 不 是 标准 的 用 户 名 称 。 


Qif (Request.IsAuthenticated) { 
<text>Welcome <strong>@(((FormsIdentity)User.Identity). 
Ticket .UserData) </strong>! 
[ @Html .ActionLink ("Log Off"™", “LogOff™, “vAuth™") ]</text> 


} 
6-8 显示 了 最 后 的 簿 未。 
注意 : 


当 要 在 身份 验证 cookie 中 添加 更 多 数据 时 ， 内 部 票据 结构 的 UserData 属性 是 首先 要 考 
虑 的 选项 。UserData 属性 正 是 为 此 目的 而 存在 的 。 不 过 ， 你 随时 都 可 以 创建 一 个 额外 的 完全 
自 定义 的 cookie， 或 者 直接 将 值 添 加 到 身份 验证 cookie 中 。 身 份 验 证 cookie 的 名 称 源 于 
FormsAuthentication.FormsCookieName 属性 的 值 。 
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Es Ey 


| 人 @ hapvmocanost2zaoo/ 


Welcome despos! | Log Off | 


ee 


Now you can do a lot more ... 


9penlIDjjiester 


6-8 用 户 已 登录 ， 且 已 显示 自 定义 昵称 
2. OpenlD 与 OAuth 


OpenID 是 一 个 单 点 登录 的 方案 ， 因 此 ， 它 虽 在 以 可 能 的 最 简单 方式 唯一 地 标识 用 户 。 
OpenID 不 涉及 授予 用 户 对 服务 提供 者 所 管理 的 资源 的 访问 权 。 或 者 ， 换 名 话说，OpenID 提 
供 者 管理 的 唯一 资源 是 注册 用 户 的 号 份 。 

社交 网 络 的 出 现 一 一 比如 Facebook、Twitter 和 LinkedIn， 将 经 典 的 单 点 登录 问题 置 在 了 
不 同 的 聚光灯 下 。 用 户 不 仅 硕 望 使 用 单个 (喜爱 的 ) 身 份 登录 到 多 个 网 站 ， 且 无 有 顷 个 个 都 注册 ， 
他 们 也 希望 被 准予 访问 自己 在 网 站 上 的 信息 和 资源 ， 比 如 帖子 、Twitter 文 、 关 注 者 、 朋 友 、 
联系 人 等 。 

与 OpenID 相 比 ，OAnuth(http:/oauth.neb 是 另 一 个 具有 附加 功能 的 单 点 登录 方案 。 充 当 
OAnuth 提供 者 的 网 站 会 作为 一 个 标识 提供 程序 运行 ， 当 用 户 登 录 时 ，OAuth 提供 程序 指定 了 
对 资源 的 权限 。 提 供 OAuth 身份 验证 的 网 站 会 使 用 特定 的 OAuth 协议 充当 提供 程序 的 客户 端 。 

这 样 的 网 站 会 对 用 户 进行 身份 验证 并 获得 一 个 访问 令 牌 ， 该 令 牌 可 进一步 用 于 访问 资源 
(例如 ， 合 并 Twitter 文 或 与 它 上 自己 的 用 户 界 面 的 联系 人 )。 最 后 ， 从 用 户 的 角度 来 看 ，OAuth 
会 授予 网 站 (或 提 面 应 用 程序 ) 用 户 对 一 个 账户 的 受 控 访问 ， 同 时 不 用 泄露 登录 的 详细 信息 。 

最 流行 的 OAuth 提供 者 是 Twitter 和 Facebook。 


注意 : 

总 体 而 言 ， 我 不 认为 网 站 开发 人 员 需 要 为 身份 验证 问题 在 使 用 OpenID 和 OAuth 之 间 做 
选择 。 你 决定 需要 对 哪个 外 部 提供 者 进行 验证 (比如 Twitter)， 然 后 结合 它 所 需 的 API， 无 论 
是 OpenID、OAuth 还 是 某 个 专 有 的 API。 如 果 正 在 开发 一 个 网 站 ， 布 望 能 允许 你 的 用 户 把 他 
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们 的 账户 (和 相关 信息 ) 分 享 给 其 他 网 站 ， 那 就 需要 在 OpenID、OAuth 和 某 专 有 协议 之 间作 出 
选择 了 。 在 这 种 情况 下 ， 我 建议 你 首先 考虑 选用 OAuth。 


重要 所 示 : 

通过 社交 网 络 进行 身份 验证 是 如 今 所 有 预计 会 有 目标 消费 者 的 网 站 都 需要 的 功能 。 通 过 
社交 网 络 进行 的 身份 验证 广 受 用户 的 赞 贯 ， 因 为 用 户 不 必 费 心 创 建 另 一 个 账户 和 记 住 另 一 对 
凭据 那么 麻烦 。 然 而 与 此 同时 ， 社 交 网 络 也 可 能 屏蔽 掉 了 对 网 站 开发 者 来 说 很 必要 的 用 户 信 
息 睫 段 ， 

如 果 要 求 用 户 登 录 ， 很 可 能 是 想 要 得 到 他 们 的 电子 邮件 地 址 。 但 通过 社交 网 络 可 能 就 不 
那么 容 努 做 到 了 。 为 此 ,以 消费 者 为 导向 的 网 站 的 普遍 做 法 是 首先 让 你 选择 通过 Twitter 还 是 
Facebook 进行 身份 验证 ， 然 后 让 你 输入 电子 邮件 地 址 以 及 其 他 个 人 信息 ， 以 完成 登录 或 注册 


6.3.2 ”通过 社交 网 络 进 行 身 份 验 证 
让 我 们 看 看 通过 Twitter 和 Facebook 对 用 户 进行 身份 验证 都 需要 些 什 么 。 在 接 下 来 的 示 


例 中 , 我 们 将 使 用 相同 的 DNOA 库 来 封闭 协议 的 详细 信息 。 我 会 将 代码 限于 进行 身份 验证 (本 
章 的 例子 中 OpenID 和 OAuth 有 少量 的 重 登 ), 但 会 调用 出 那些 OAuth 扩展 OpenID 方案 的 点 。 


1. 用 Twitter 注册 你 的 应 用 程序 


OAnuth 提供 程序 的 处 理 需 要 一 些 预备 步骤 。 首 先 你 必须 用 社交 网 络 注册 你 的 应 用 程序 ， 
得 到 两 个 字符 串 : 消费 者 键 值 和 消费 者 密 铀 。 在 对 提供 程序 进一步 的 编程 请 求 中 ， 你 将 要 座 
入 这 些 字 符 串 。 

这 一 处 理 过 程 在 Facebook 和 Twitter 中 几乎 是 相同 的 。 我 会 在 这 里 讨论 Twitter。 整 个 处 
理 过 程 从 http://dev.twitter.com 开始 。 图 6-9 显示 了 一 个 现 有 应 用 程序 的 配置 页 面 。 

特别 是 ， 你 要 在 用 户 资源 上 设置 应 用 程序 的 类 型 和 默认 权限 。 回 调 URL 字段 值得 关注 。 
该 URL 是 Twitter 在 成 功 对 某 用 户 进 行 身 份 验证 之 后 所 返回 的 。 你 不 太 可 能 希望 这 个 URL 是 
固定 的 。 但是， 如 果 应 用 程序 是 Web 应 用 程序 ，Twitter 就 会 要 求 不 要 让 该 字段 为 空 。 如 果 因 
为 你 打算 为 每 一 个 调用 指定 一 个 回调 URL 而 让 这 个 字段 为 空 的 话 ， 那 么 Twitter 就 会 重 写 设 
置 的 应 用 程序 的 类 型 ， 强 制 设置 为 果 面 应 用 程序 。 实 际 效果 是 ， 对 任何 用 户 进 行 喘 份 验证 的 
符 试 都 会 返回 未 授权 。 分 配 任意 一 个 URL， 包 括 导 致 404 消息 的 URL( 如 本 示例 所 示 ) 都 会 起 
到 作用 。 
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ee) WF https://dev.twitter.com/apps/1033197/settings 


共 Dino Esposito - OQutlook,.. 请 Getting started with An... | WB LazyForDates | Twitte... X 


到 Developers Search 和 API Health Blog Discussions Documentp, : 


Application lcon 


Change icon: 


Marimum se of 7O0k. JPG, GIF PNG. 


Application Type 


MAccess: 

OO Read only 

他 Read and Write 

OO Read, Write and Access direct messages 


What type of access does your application need? Note: @Amwhere applications require read & Write access. 
Find out more about our Application Permission Model. 
Callback URL: 


htto://expoware.orao 


Where should we retum after successfully authenticating? For BAnywhere applications, only the domain specified in the callback will 


https://dev.twitter.com/status 号 100% = E 


图 6-9 用 Twitter 注册 一 个 应 用 程序 
2. 在 ASP.NET MVC 中 启用 社交 身份 验证 


在 ASPNETMVC4 之 前 , 你 都 不 得 不 用 目 己 的 方式 编写 在 Twitter 和 Facebook 上 进行 号 
份 验证 的 代码 。 DNOA 库 的 帮助 民 多 , 但 它 所 提供 的 只 是 一 个 低级 别 的 编程 接口 , 这 与 OAuth 
协议 的 特点 非常 接近 。 在 ASPNET MVC 中 , 你 会 发 现 一 个 可 用 的 新 类 一 一 OAuthWebSecurity 
类 一 一 它 提供 了 对 OAuth 身份 验证 的 全 面 文 持 。 尤 其 是 , 该 尖 提 供 了 一 些 可 以 插入 文 持 OAuth 
的 大 众 社交 网络 的 便利 方法 。 

刁 份 验证 方法 采用 了 RegisterXxxClient 的 形式 。 并 提供 了 文 持 Twitter、Facebook、 人 谷歌、 
领 天 、 雅 虎 和 微软 的 现成 方法 。 

如 果 从 标准 模板 局 动 你 的 ASPNET MVC 项 目 ， 就 会 发 现 从 globalasax 处 调用 的 如 下 
代码 : 

OAuthWebSecurity.ReglisterTwitterClient( 


CONnSUMSrKReY: ”--。- 


fr 
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consumerSecret: ”--- ) 


OAUthWebSecurlItYy-Redl1sterFacebookCllent ( 
apPId : mm 
appSecret: ™..."); 


确切 地 说 ， 此 代码 会 被 注释 掉 ， 并 且 必 须 以 用 于 社交 应 用 程序 的 实际 密 钥 和 安全 密码 在 
百 台 完成 。 然 而 ， 即 使 你 不 使 用 任何 标准 项 目 模 板 ， 也 建议 看 看 默认 模板 中 用 于 社交 里 份 验 
证 的 源 代 码 。 

只 要 有 了 代码 的 前 面 两 行 ,就 可 以 从 预定 义 的 ASPNET MVC 模板 中 得 到 如 图 6-10 所 示 
的 结果 。 


OO Waiting for localhost 


Log in. 


Use a local account to log in. Use another service to log in. 


User name 


Twitter ] Facebook | 
| = 


Password 


LI Remember me? 


Log in 


https/ /localhost1l166/Account/ExternalLogin?ReturnUrl= 


图 6-10 共有 双重 接口 的 登录 页 面 示 例 


如 果 用 户 键入 用 户 名 和 密码 并 单 击 Log In 按钮 ， 一 切 将 正常 进行 ， 验 证 和 凭据 存储 的 担 
子 就 落 在 了 你 的 导 上 。 人 否则 ， 会 将 用 户 重 定 同 到 Twitter 或 Facebook 进行 导 份 验证 。 如 果 瑟 
份 验 证 成 功 ， 访 用 户 又 会 被 重 定 回回 来 。 

整个 处 理 过 程 使 用 了 DNOA 库 编 码 ; 但 是 ，ASPNET MVC 提供 了 一 些 简化 编码 的 封装 
类 ， 更 重要 的 是 ， 提 供 了 通过 社交 网 络 抓 取 用 户 信息 以 及 之 后 将 数据 保存 到 本 地 成 员 资 格 系 
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重要 提示 : 
我 不 知道 有 多 少 开 发 人 员 实 际 上 从 Visual Studio 标准 模板 开始 构建 ASPNET MVC 应 用 


程序 的 。 然 而 ， 就 社交 身份 验证 而 言 ， 标 准 模板 中 的 实现 模式 绝对 值得 一 看 。 


3. 局 动身 份 验证 处 理 过 程 
当 用 户 单 击 Twitter( 或 Facebook) 按 钮 时 ， 网 站 最 终 会 调用 Account 控制 右上 的 
ExternalLogin 方法 。 下 面 是 所 涉及 的 代码 : 


public ActionResult ExternalLogqln(Strlnd provider, String returnUr]l) 


{ 
return new ExternalLoginResult (provider, 
Url.Action ("ExternalLoginCallback", 
new { ReturnUrl] = returnUrl })); 
} 


ExternalLoginResult 类 是 用 于 以 下 代码 的 封装 , 它 切 实 做 着 联系 身份 验证 网 关系 统 的 工作 : 
OAuthWebsSecurity.RequestAuthentication (Provider, ReturnUr]l); 


ExternalLoginResult 类 也 是 可 以 在 AccountController.cs 文件 中 找到 的 帮助 右 关 。 你 应 访 
要 注意 到 在 项 目 模板 代码 中 ， 提 供 程序 的 名 称 是 通过 查看 按钮 的 名 称 特性 来 解决 的 。 


<button type="submit" 
name="provider" 
value="(@p.AuthenticationClient.ProviderName" 
title="Log in using your @p.DisplayName account"™"> 
Qp .D1isplayName 
</button> 
在 一 天 结束 时 ， RequestAuthentication 方法 会 接收 到 号 份 验证 提供 者 (Twitter、Facebook 
或 其 他 任何 受 文 持 的 提供 者 ) 的 名 称 和 返回 的 URL。 也 可 以 直接 从 登录 控制 器 方法 的 调用 中 
当 请 求 到 达 Twitter 网 站 时 ， 用 己 会 被 重 定 同 到 如 图 6-11 中 所 示 的 授权 页 面 。 
如 果 用 户 ( 在 这 个 例子 中 是 我 的 账号 ) 已 经 登录 到 Twitter, 他 只 会 被 要 求 问 请 求 的 应 用 
程序 授权 。 人 否则 ， 他 需要 首先 登录 Twitter， 然 后 授权 。 接 下 来 ，Twitter 会 重 定 回 回 指定 
的 URL。 
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对 Twitter Authorize an appl... 


Ewitter 


Authonlze LazyForDates to use YOUT 

account? 

This application will be able to: 

LazyForDates 

By 上 xpoware Soft 
Www.expoware-orgjime... 


= Read Tweets from your timeline. 

* See Who you follow. 

=” ACCESS YOUr direct messages Until June 30th, 2011. Helping people tracking 
dates absolutely (like a 


; calendar) and relatrvely 
Authorize app No, thanks (when ee 1000 Y 


day/min/week since) and 
E counting down to an 
This application will not be able to- important date. 
= Follow new people. eam id elu i 
= Update your profile . app 


图 6-11 Twitter 上 的 用 户 身 份 验 证 并 授予 请 求 应 用 程序 访问 账户 信息 的 权限 
4. 处 理 Twitter 响应 


如 果 用 户 输入 了 Twitter( 或 选择 的 社交 网 络 ) 能 有 效 识 别 的 凭据 ，Twitter 网 站 就 会 重 定 回 
回 所 提供 的 返回 URL。 男 一 种 方法 可 以 让 你 重 拾 通过 身份 验证 的 控制 ， 这 就 是 
ExternalLoginCallback.。 

现在 你 只 知道 试图 访问 你 应 用 程序 的 用 户 已 经 被 成 功 识 别 为 Twitter 用 户 。 你 不 知道 有 关 
他 的 任何 信息 ; 其 至 是 用 户 名 称 。 我 很 难 想到 一 个 需要 进行 用 户 喘 份 验证 的 应 用 程序 可 以 无 
关 痛 痒 地 忽略 用 户 名 或 电子 邮件 地 址 。 身 份 验 证 步 又 结束 时 , 应 用 程序 只 会 接收 到 一 个 代码 ， 
但 尚未 被 授权 以 编程 方式 访问 TwitterAPI。 为 此 ， 在 这 一 阶段 收 到 的 代码 必须 被 交换 成 访问 
令 脾 (通常 有 时 间 限 制 以 防止 洲 用 )。 这 是 对 你 在 ExternalLoginCallback 正文 中 找到 的 
VerifyAuthentication 方法 进行 调用 的 目的 。 

从 VernityAuthentication 返回 的 AuthenticationResult 对 象 会 带 回 一 些 有 关 用 户 的 信息 。 你 
得 到 的 实际 信息 可 能 会 根据 不 同 的 提供 者 而 略 有 不 同 ; 但 一 般 至 少 会 包含 用 户 名 称 。 


5. 从 吴 份 验证 到 成 员 资格 


对 用 户 进行 身份 验证 只 是 第 一 步 ， 接 着， 你 需要 根据 用 户 名 在 网 站 中 跟 蹊 用户 。 在 经 典 
的 ASPNET 成 员 资 格 系统 中 ,你 首先 要 显示 一 个 登录 表单 、 验 证 和 凭据， 然后 创建 一 个 完全 填 
充 用 户 名 称 和 其 他 选择 性 关键 信息 的 身份 验证 cookie。Twitter 和 Facebook 为 你 省 去 了 设置 登 
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录 表 单 、 验 证 凭据 ， 以 及 存储 和 管理 像 密码 这 样 的 账户 敏感 信息 的 任务 。 

不 过 ， 差 不 多 所 有 需要 进行 用 户 身份 验证 的 应 用 程序 最 起 码 都 需要 一 个 能 按 名 称 跟 踪 各 
个 普通 用 户 的 成 员 资格 系统 。 建 立 这 样 一 个 系统 仍然 是 你 自己 必须 完成 的 任务 。 如 前 所 述 ， 
ASPNET MVC 基本 模板 提供 了 一 个 额外 的 步骤 来 帮忙 解决 该 问题 ， 在 此 期 间 用 户 会 自动 获 
取 一 次 输入 其 显示 名 称 的 机 会 ， 然 后 保存 到 本 地 成 员 资格 表 。 这 只 有 在 用 户 首次 登录 到 指定 
网 站 时 才 需 要 。 换 言 之 ， 图 6-12 中 所 示 的 表单 会 服务 于 连接 注册 和 首次 登录 的 目的 。 


witterB_sid_=9a4152307d494d6da73aaed5bc07d4 ~ 妨 册 关上 eo 


Register ”Log in 
Home About Contact 
Register. Associate your Twitter account. 


You've successfully authenticated with Twitter. Please enter a User Name for thts site below and click the Confirm button to 和 nish lagging in. 


User name 


despos 


© 2013 - Ny ASP.NET MVC Application 


hitp:/ /localhostd1166/Account/ExtemalLoginConfirmation 


图 6-12” 完成 与 网 站 注册 一 起 的 登录 过 程 


在 这 一 阶段 输入 的 名 称 用 于 创建 ASPNET 身份 验证 cookie, 它 将 明确 地 结束 这 一 操作 闭 
环 : 用 Twitter 核实 凭据 、 要 求 用 户 输入 其 显示 名 称 、 并 创建 一 个 常规 的 身份 验证 cookie。 从 
现在 起 ，ASPNET 中 需要 身份 验证 的 网 站 就 可 以 开始 正常 工作 了 。 

重要 提示 : 

不 论 你 是 否决 定 合并 登录 和 注册 ， 你 都 有 必要 用 OAuth 提供 程序 (如 果 有 的 话 ) 所 返回 的 
用 户 名 称 设法 创建 一 个 经 典 的 ASPNET 身份 验证 cookie。 

该 应 用 程序 示例 ， 在 很 大 程度 上 是 基于 默认 的 ASPNET MVC 项 目 模 板 的 ， 将 用 户 数 据 
保存 到 App Data 文件 夹 下 的 一 个 MDF 本 地 数据 库 中 。 这 个 表 通 过 使 用 简单 的 从 Web Pages 
框架 继承 来 的 成 员 资 格 API 来 进行 管理 。 

下 面 的 代码 显示 了 示例 项 目 模 板 是 如 何 检 索 如 图 6-12 中 所 示 的 用 户 显 示 名 称 的 。 


Var loginData = OAuthWebSecurity.SerializeProviderUserlIdl 
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result.Provider, result.ProviderUserId); 
Var name = OMAuthWebSecurity 
.GetOAuthClientData (result.Provider) 
.DisplayName; 
return View ("ExternalLoginConfirmation"™., 
new ReglisterExternalLoginModel { 
UserName = result .UserName, 
ExternalLoginData = loginData 
}); 
对 GetOAuthClientData 的 调用 可 以 让 你 访问 Twitter 提供 程序 共享 的 有 关 登 录用 户 的 信 
思 。 接 着 ，ExternalLogicConfirmation 视图 会 提供 图 6-12 的 实际 标记 。 当 用 户 单 击 注册 时 ， 
会 发 生男 一 个 对 账户 控制 器 的 回调 , 具体 来 说 是 对 ExternalLoginConfirmation 方法 进行 回调 。 
在 此 方法 的 主体 中 ， 有 两 件 关 键 事 情 发 生 ， 归 纳 如 下 : 
OMAuthWebSecurity.createOoOrUpdateAccount ( 


provider, providerUserId, model .UserName); 
OAuthWwebSecurity.Login'l( 


provider, providerUserId, createPersistentCookie: false); 


第 一 行 会 为 应 用 程序 的 成 员 资 格 本 地 数据 库 设 置 新 的 记录 。 第 二 行 会 实际 创建 身份 验证 
cookie。 默 认 模 板 提 供 了 大 量 的 数据 库 表 , 比如 UserProfiles 和 webPages OAuth Membership。 
webPages_OAuthMembership 表 会 用 提供 程序 的 名 称 (比如 Twitter)、 提供 程序 用 于 用 尸 的 唯一 
ID 以 及 指 同 内 部 卫 的 指针 来 存储 记录 , 指 回 内 部 卫 的 指针 能 够 以 用 户 目 己 在 图 6-12 中 的 
页 面 上 所 选择 的 显示 名 称 来 唯一 标识 UserProfiles 表 中 的 用 户 。 


重要 提示 : 

要 测试 Twitter 身份 验证 , 需要 一 对 真实 的 用 户 键 值 /用 户 密 钥 ,但 不 一 定 非 得 从 公共 Web 
服务 器 上 测试 。 可 以 从 自己 的 Visual Studio 环境 从 容 地 进行 测试 ， 并 使 用 localhost:port 作为 
回调 URL 的 根 目 录 。 


6. 超出 身份 验证 的 内 容 


如 前 面 各 市 所 述 ， 虽 然 大 多 数 网 站 只 使 用 社区 网 络 来 验证 用 户 喘 份 ， 但 仍然 有 很 多 可 以 
由 网 站 自己 去 做 的 事情 。 在 用 户 的 凭据 通过 验证 以 后 ， 几 乎 所 有 的 外 部 提供 丙 ( 当 然 也 包括 
Twitter 和 Faceboog 都 会 返回 一 个 称 为 访问 令 牌 的 含有 字母 和 数字 的 字符 串 。 

访问 令 牌 是 一 个 重要 的 信息 ， 因 为 它 会 授予 网 站 在 用 户 要 求 和 授权 的 范围 内 代表 用 户 对 
社交 网 络 进行 操作 的 权限 ， 正 如 图 6-9 中 所 摘 绘 的 。 简 而 言 之 ， 如 果 只 是 为 了 对 用 户 进 行 号 
份 验证 ， 则 采集 和 存储 访问 令 牌 并 不 重要 ， 但 如 果 和 硕 望 提供 更 多 的 功能 ， 例 如 代表 用 户 发 帖 
或 检索 更 多 个 人 信息 ， 那 么 采集 和 存储 访问 令 牌 就 变 得 很 重要 了 。 
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注意 : 

访问 令 牌 不 可 能 永远 存续 下 去 。 例 如 ，Facebook 令 牌 往往 很 快 就 到 期 ， 而 Twitter 令 牌 
持续 的 时 间 稍 长 一 些 。 如 何 处 理 访问 令 牌 需要 有 具体 问题 具体 分 析 ， 但 一 般 情况 下 ， 好 的 策略 
是 在 每 次 用 户 登 录 时 保存 访问 令 牌 。 可 以 将 其 保存 到 会 话 状态 ， 或 者 更 好 的 是 ， 保 存 到 一 个 
数据 库 。 


如 何 检索 访问 令 牌 呢 ? 
访问 令 牌 可 以 在 ExternalLoginCallback 方 法 中 找到 ; 即 ， 和 号 份 验 证 成 功 后 出 现在 你 代码 
中 的 前 个 入 口 点 。 上 有 具体 来 说 ， 可 以 在 AuthenticationResult 对 象 的 ExtraData 属性 中 找到 它 。 


1f (result.ExtraData.Keys.Contains ("accesstoken"™"™)) 


{ 


// Save the access token for later use: result.ExtraData[l"accesstoken"™| 


} 

例如 ， 可 以 使 用 访问 令 牌 检索 用 户 的 更 多 信息 。 请 记 住 超越 简单 身份 验证 的 功能 都 需要 
针对 特定 社交 了 网络 的 专用 软件 开发 工具 包 (SDK)。 要 与 Twitter 进行 交互 ， 你 可 能 要 用 
TweetSharp。 而 对 于 Facebook， 最 好 的 选择 是 用 于 C# 的 Facebook Client SDK。 这 两 个 库 都 很 
容易 通过 NuGet 访问 。 下 面 是 一 个 用 于 抓 取 Facebook 用 户 额外 信息 的 代码 段 : 

Var client = new FacebookClient (accesstoken).; 

dynamic user = client.Get ("/me", new { fields = "first name,1last name,emall™" }); 

使 用 类 似 的 语法 ， 可 以 访问 当前 用 户 的 社交 信息 记录 。 更 多 的 相关 信息 可 以 参考 所 选择 
的 社交 网 络 站 点 上 的 开发 人 员 页 面 。 


6.4 本草 小 结 


安全 性 总 是 被 看 作 Web 应 用 程序 的 热门 话题 。 因 此 几乎 任何 有 关 Web 技术 的 课程 或 书 
籍 都 会 单独 划 出 一 个 章节 来 讲述 如 何 编写 安全 应 用 程序 。 假 如 某 个 人 了 解 基 本 的 安全 性 以 及 
用 于 经 典 ASPNET 的 Forms 身份 验证 (比如 Web Forms)， 那 么 在 ASPNET MVC 中 也 就 没有 
太 多 要 学 习 的 了 。 

运行 时 管道 与 Web Forms 中 的 相同 ， 并 且 信 任 级 别 和 进程 标识 也 是 以 完全 相同 的 方式 建 
立 的 。 此 外 ，Forms 身份 验证 也 是 通过 HTTP 模块 和 一 个 高 度 可 配置 的 cookie 以 相同 的 方式 
运行 的 。 可 以 参考 我 的 一 本 有 关 ASPNET 的 书 Proerammineg ASPNET 4( 做 软 出 版 社 ，2011 
年 出 版 )， 其 中 的 第 19 章 有 关于 这 些 话题 的 深入 讨论 。 

特定 于 ASPNET MVC 的 是 ， 在 其 中 限制 对 操作 方法 和 控制 授权 访问 的 方式 。 本 章 的 前 
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半 部 分 涵盖 了 这 些 内 容 。 后 半 部 分 谈 及 ， 现 在 越 来 越 多 的 应 用 程序 集成 了 通过 外 部 服务 进行 
用 户 身份 验证 的 队伍 。 可 以 通过 一 些 单 点 登录 方案 和 底层 协议 一 -OpenID 与 OAuth 来 实现 
这 一 点 。 尽 管 OpenID 基本 上 能 用 于 唯一 标识 用 户 ， 但 OAuth 却 可 以 做 得 更 多 。OAuth 可 以 
从 用 户 那里 获得 由 服务 提供 商 所 持 有 的 应 用 程序 能 够 使 用 的 资源 的 权限 。 这 一 章 展示 了 一 个 
使 用 流行 的 Twitter 社交 网 络 进行 用 户 身份 验证 的 OAuth 应 用 程序 示例 ， 它 可 以 为 自己 获得 
读 取 Twitter 文 以 及 连接 到 已 登录 用 户 的 关注 者 的 权限 。 


中 


设计 ASP.NET MVC 控制 器 的 注意 事项 


计算 机 非 人 性 的 一 部 分 表现 是 ， 一 旦 完成 编译 并 且 顺 利 运 行 ， 它 将 忠实 地 完成 工作 . 


Tsaac Asimov 


控制 器 是 在 ASPNET MVC 中 执行 任何 操作 的 核心 元 素 。 控 制 器 负责 获取 提交 的 数据 、 
执行 相关 的 操作 、 然 后 准备 和 请 求 视 图 。 这 些 看 似 简单 的 步骤 通常 会 生成 大 量 的 代码 。 更 精 
的 是 相似 的 代码 最 终 会 被 用 到 相似 的 方法 中 ， 相 似 的 帮助 器 类 却 没有 地 方 放置 。 

ASPNET MVC 会 保障 更 易于 编写 清洁 和 易于 测试 的 代码 的 基础 。 可 以 青 定 的 是 ， 
ASPNET MVC 基于 的 基础 架构 使 这 一 保障 有 了 实现 的 可 能 ， 并 且 比 在 Web Forms 中 更 容易 
实现 。 但 是 仍然 有 很 多 工作 留 给 了 开发 人 员 、 及 其 编程 准则 和 设计 构想 。 

从 架构 上 来 说 ， 控 制 器 类 似 于 Web Forms 中 的 代码 隐藏 类 。 它 是 表示 层 的 一 部 分 ， 以 某 
种 方式 存在 以 便 将 请 求 发 送 到 应 用 程序 的 后 端 。 如 果 缺 乏 了 开发 准则 ， 控 制 器 会 很 容易 凌乱 
地 增长 并 且 无 法 理 清 ， 束 像 吉 式 的 代码 隐藏 闫 一样。 所 以 ， 仅 仅 选择 ASPNET MVC 并 不 能 
确定 你 能 否 保证 代码 的 整洁 度 和 质量 。 

在 本 章 中 ， 我 们 将 探讨 一 个 对 ASPNET MVC 的 设计 方法 ， 该 设计 方法 会 简化 你 需要 机 
械 化 实现 控制 器 类 的 步 台 。 其 理念 就 是 使 控制 器 成 为 一 个 至 精 至 简 的 类 ， 以 委托 所 肩负 的 任 
务 而 不 是 靠 其 自身 去 组 织 编排 任务 。 这 种 设计 对 应 用 程序 的 其 他 层 以 及 ASPNET MVC 基础 
染 构 的 菜 些 部 分 均 有 影 啊 。 


7.1 打道 你 的 控制 希 
微软 Visual Studio 会 让 你 很 容易 地 创建 自己 的 控制 器 类 ,为 此 ,只 需要 右 击 当前 ASPNET 


MVC 项 目 中 的 项 目 文件 夹 ， 并 添加 一 个 新 的 控制 器 类 即 可 。 在 控制 费 类 中 ， 每 一 个 沙 在 控 
制 器 职责 范围 内 的 用 户 操作 都 会 有 一 个 方法 。 那 么 操作 方法 是 如 何 进 行 编码 的 呢 ? 
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注意 : 

ASPNET MVC 的 Visual Studio 工具 让 你 不 再 仅仅 局 限于 在 Controllers 文件 夹 中 添加 控 
制 器 类 。 可 以 在 任何 地 方 放置 控制 器 类 ， 并 且 右 击 任何 一 个 文件 夹 都 将 显示 创建 新 的 空白 控 
制 器 类 的 命令 。 


操作 方法 会 收集 输入 数据 ， 并 将 其 用 于 准备 对 由 应 用 程序 中 间 层 所 公开 的 茶 些 疹 点 进行 
一 次 或 多 次 的 调用 。 接 痢 ， 它 会 接收 输出 数据 ， 确 保 输出 数据 的 格式 正 是 视图 所 需要 接收 的 。 
os had 调 出 视图 引擎 以 呈现 某 个 具体 的 模板 。 
能 所 有 这 些 加 起 来 几 行 代 码 的 工作 也 会 使 得 即便 是 带 有 几 个 方法 的 控制 器 类 变 成 一 
Ps poesia tehsil ein tp trent ea 倪 图 的 调用 只 十 调 
用 一 个 能 触发 处 理 操 作 结 果 的 方法 。 操 作 方 法 的 核心 位 于 执行 任务 和 为 视图 准备 数据 的 代 
码 中 。 


7.1.1 选择 正确 的 原型 


一 般 来 说 ， 操 作 方 法 可 能 有 两 种 角色 : 可 以 是 一 个 控制 器 ， 也 可 以 是 一 个 协调 器 。“ 控 
制 器 ”和 “协调 器 ”这 样 的 字眼 是 从 哪里 来 的 呢 ? 很 明显 ， 在 这 种 上 下 文 背 景 中 “控制 器 ” 
这 个 词 与 ASPNET MVC 控制 器 类 并 无 关联 。 

这 两 个 词 指 的 是 对 象 原型 ， 一 个 来 自 于 被 称 为 职员 驱动 设计 (Responsibility-Driven 
Design，RDD) 方 法 的 概念 。 通 常情 况 下 ，RDD 适用 于 系统 上 下 文中 对 象 模 型 的 设计 ， 但 它 
的 一 些 概念 同样 适用 于 相对 比较 简单 的 操作 方法 行为 建 模 的 问题 。 


注意 : 

RDD 的 更 多 相关 信息 ,请 查阅 Rebecca Wirfs-Brock 和 Alan McKean 合 著 的 Object Desien: 
Roles, Responsibilities, and Collaborations 一 书 (Addison-Wesley，2002 年 出 版 )。 

1. RDD 概览 

RDD 的 本 质 在 于 将 系统 功能 分 解 成 系统 应 当 执行 的 奉 干 操作 。 接 独 ， 每 一 个 操作 会 被 映 
射 到 正在 进行 设计 的 系统 的 一 个 对 象 。 执 行 该 操作 就 变 成 了 这 个 对 象 的 具体 职责 。 对 象 的 作用 
取决 于 它 所 承担 的 职责 。 表 7-1 描述 了 RDD 的 主要 概念 ,， 并且 定 义 了 一 些 与 其 使 用 相关 的 术语 。 


表 7-1 标准 RDD 概念 和 术语 


概念 描 述 
应 用 程序 是 指 相互 连接 和 相互 作用 对 象 的 集合 
协作 是 指 共同 运行 以 提供 一 些 有 意义 行为 的 两 个 对 象 之 同 建立 的 天 系 。 协作 这 个 术语 是 退 


过 显 式 协议 定义 的 
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( 续 表 ) 
概念 描 述 
对 象 是 指 实现 一 个 或 多 个 角色 的 软件 组 件 
角色 是 指 承担 一 个 相关 职责 的 软件 组 件 的 特性 
职责 是 指 对 象 的 预期 行为 。 原 型 用 于 归 类 职责 


表 7-2 总 结 了 对 象 职责 的 主要 分 类 。 它 们 统称 为 对 象 角色 原型 。 
表 7-2 标准 RDD 原型 


控制 右 组 织 安排 其 他 对 象 的 行为 ， 并 决定 其 他 对 象 应 该 做 什么 
办 调 占 由 事件 请 求 ， 它 会 给 其 他 对 象 委 托 任务 

信息 人 存储 耸 存储 (或 知 肯 如 何 获 取 ) 信 息 并 提供 信息 

交互 器 表示 实现 对 象 之 同 通 信 的 外 观 醒 陈 

服务 提供 程序 针对 请 求 执行 特定 操作 

结构 骨 筷 理 对 象 之 间 的 关系 


在 RDD 中 ， 每 个 软件 组 件 都 会 在 特定 的 情形 下 发 挥 作用 。 当 使 用 RDD 时 ， 你 要 运用 原 
型 为 每 一 个 对 象 指派 其 角色 。 我 们 看 看 如 何 将 RDD 原型 应 用 到 操作 方法 上 。 


2. 对 请 求 的 执行 进行 分 解 


我 已 经 换 述 了 所 有 操作 方法 要 实现 的 一 些 常见 步 怠 。 我 们 可 以 把 操作 方法 的 职责 分 解 
如 下 : 

e 攻取 随 请 求 友 壕 鸭 输入 数据 

e 执行 与 请 求 相关 的 任务 

e 准备 用 于 啊 应 的 视图 模型 

e 调用 下 一 个 视图 

可 以 使 用 控制 器 也 可 以 使 用 协调 器 RDD 原型 来 实现 操作 方法 一 一 但 两 者 产生 的 效果 不 
一 梓 。 


3. 充当 “控制 器 ” 


让 我 们 考虑 一 个 简单 的 订购 用 例 中 的 操作 方法 。 在 现实 世界 中 ， 下 订单 绝对 不 只 是 像 你 
在 入 门 级 教程 中 所 看 到 的 那样 ， 往 Order 表 中 添加 一 个 记录 那么 简单 。 
下 订单 的 操作 通常 涉及 几 个 步 又 和 对 象 。 例 如 ， 它 可 能 需要 查询 数据 库 ， 找 出 订购 货物 
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的 库存 。 还 可 能 需要 同 供应 商 订 购 一 个 单独 的 订单 来 补充 库存 ， 并 且 通 党 需要 检查 客户 的 信 
用 状况 ， 以 及 与 客 己 的 银行 和 运输 公司 进行 协同 。 最 后 ， 它 还 涉及 对 茶 些 数据 库 表 进行 更 新 。 


当 订 购 成 功 以 后 ， 系 统 会 返回 以 便 回 用 户 显 示 订 单 DDD， 也 许 要 打印 发 票 ， 还 可 能 要 估计 交 货 
日 期 。 
下 面 的 伪 代 码 会 让 你 对 需要 采取 的 具体 步骤 有 一 个 概念 : 
[HttpPosti 
public ActionResult PlaceOrder (OrderIinfo order) 
{ 


// Input data already mapped thanks to the model binder 
// Step 1-Check goods avallability 

py 2-ChecKk credit status of the customer 

Pe 3-Sync up with the shipping company 

// step 4-Upaate databases 


// Step 5-Notify the customer 


// Prepare the view model 
Var model = PlaceOrderViewModel { ... }; 


// Invoke next vliew 
return View (model); 


} 

最 起 码 ， 对 所 有 这 些 步骤 在 控制 器 中 进行 编码 意味 着 你 最 终 要 从 表示 层 对 数据 访问 层 进 
行 调用 。 对 于 简单 的 Create、Read、Update、Delete(CRUD) 应 用 程序 来 说 是 可 以 接受 的 ， 但 
对 于 更 复杂 的 应 用 程序 来 讲 就 不 可 接受 了 。 

即便 每 个 列 出 的 步骤 可 以 用 一 行 或 两 行 代 码 解 决 ， 但 你 仍然 会 面临 一 个 长 得 无 法 控制 的 
方法 。 应 用 于 ASPNET MVC 控制 器 类 的 RDD 控制 器 原型 会 提示 你 使 用 以 前 的 代码 结构 。 
但 这 即使 对 于 不 那么 复杂 的 应 用 程序 来 说 也 未 必 是 理想 的 选择 。 


重要 提示 : 

用 例 实 现 背 后 的 业务 流程 会 涉及 可 能 属于 系统 架构 中 不 同 层 的 多 个 组 件 。 某 些 步骤 会 通 
过 域名 服务 (比如 准备 发 票 ) 来 实现 ; 其 他 步骤 可 能 要 由 外 部 服务 (例如 ， 从 合作 运输 公司 的 关 
联系 统 获 取 交 货 人 信息) 来 实现 ; 更 多 的 步骤 可 能 只 是 数据 库 的 调用 (获得 订单 ID)。 所 有 这 些 调 
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用 都 应 被 视 为 由 表示 层 所 触发 的 单个 工作 流 步 又。 
4. 充当 “协调 器 ” 


RDD 协调 器 会 建议 你 将 所 有 这 些 步骤 组 织 在 单个 工作 线程 对 象 中 ， 形 成 操作 的 实现 。 从 
操作 方法 内 , 对 工作 线程 进行 单个 调用 并 将 其 输出 的 数据 用 于 视图 模型 对 象 ,下面 是 其 结构 : 
[HttpPosti 
public ActionResult PlaceOrder (OrderIinfo order) 
{ 
// Input data already mapped thanks to the model binder 


// Perform the task invoking a worker service 
Var SerVlce = new OrderService().; 
Var response = service.PerformSomeTask (); 


// Prepare the view model 
Var model = PlaceOrderViewModel (response); 


// Invoke next view 
return View (model); 
} 
现在 ASPNET MVC 控制 项 方 法 的 总 体 结 构 简 单 得 多 了 。 由 传 入 的 HITP 请 求 提 出 请 求 ， 
操作 方法 将 大 部 分 任务 转发 给 协调 后 面 所 有 步骤 的 另 一 个 组 件 。 我 把 这 些 组 件 称 为 工作 线程 
服务 ， 或 直接 叫做 应 用 程序 服务 。 


重要 提示 : 

工作 线程 服务 或 应 用 程序 服务 属于 系统 的 应 用 程序 层 。 应 用 程序 层 是 实现 从 用 例 中 所 产 
生 的 应 用 程序 远 辑 的 地 方 。 这 一 层 不 能 重用 ， 因 为 它 是 特定 于 应 用 程序 (和 前 端的 。 可 重用 
性 要 推 至 下 一 层 的 域 层 中 。 意 即 核 心 功能 是 可 重用 的 (也 就 是 域 )， 但 呈现 工作 流 会 特定 于 应 
用 程序 。 这 里 有 一 个 简单 的 例子 来 说 明 这 一 点 : 在 台式 机 前 端 ， 你 可 能 有 一 个 表单 来 获取 所 
有 数据 ,而 在 移动 前 端 你 可 能 需要 经 过 多 个 表单 ,每 个 表单 可 能 都 需要 与 后 端 进行 一 些 交互 。 
核心 功能 (比如 下 订单 或 与 运输 公司 协同 ) 保 持 可 重用 性 ; 工作 流 需 要 加 以 调整 。 


7.1.2 ”精简 的 控制 北 


ASPNET MVC 是 一 个 旨 在 方便 测试 和 推动 像 关注 点 分 离 (SoC) 和 依赖 性 注入 (DD 这 样 的 
重要 原则 的 框架 。ASPNET MVC 会 通知 你 应 用 程序 被 分 隔 为 称 作 控制 器 的 部 分 和 称 作 视图 
的 部 分 (更 不 用 说 这 里 讨论 的 模型 了 )。 被 强制 创建 一 个 控制 器 类 并 不 意味 着 你 就 能 自动 取得 
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适当 的 SoC 水 平 ， 也 不 意味 着 你 要 编写 测试 代码 。 正 如 第 1 章 “ASPNET MVC 控制 器 ”中 
所 述 ，ASPNETMVC 给 了 你 一 个 好 的 开始 ， 但 后 面 ( 所 需 ) 的 分 层 取 决 于 你 。 

我 可 能 还 没有 说 得 太 清楚 的 是 ， 如 果 不 够 注意 的 话 ， 则 可 能 最 终 得 到 的 是 一 个 爱 肿 和 凌 
乱 的 控制 器 类 ， 它 当然 也 不 会 比 混乱 (和 让 人 看 不 上 眼 ) 的 代码 隐藏 类 更 好 。 所 以 ， 你 应 该 尽 
量 将 控制 器 类 创建 得 像 精 简 和 平均 的 端点 集合 一 样 ， 并 移 除 其 中 的 任何 款 装 。 


注意 : 

按照 我 的 标准 ， 旱 些 时 候 我 并 不 确定 是 否 应 该 把 DI 看 作 一 项 原则 。 上 有 具体 地 说 ，DI 只 是 
用 于 实现 依赖 反 转 原则 的 受 欢 迎 模式 ， 据 此 ， 从 属 类 之 间 的 接触 面 应 该 始终 是 一 个 接口 而 不 
是 实现 。 比 DI 更 少 为 人 所 知 ( 和 理解 ) 的 是 ， 依 赖 反 转 原则 是 流行 的 SOLID( 单 一 职责 、 开 闭 
原则 、 里 氏 和 替换 、 接 口 隔离 以 及 依赖 反 转 原则 ) 首 字母 缩写 中 的 “D”，SOLID 总 结 了 编写 整 
洁 、 高 质量 代码 的 五 个 关键 设计 原则 ， 


1. 精简 总 是 更 好 的 


如 果 有 一 个 长 约 100 行 逻辑 的 方法 ， 该 代码 就 可 能 包含 10 到 15 行 的 注释 。 一 般 而 言 ， 
10% 的 代码 注释 被 认为 是 一 个 合理 的 比例 ， 如 果 和 希望 为 所 做 的 解释 清楚 来 龙 去 脉 ， 切 实 帮 到 
在 你 之 后 处 理 这 些 代 码 片 段 的 人 ， 我 觉得 注释 比例 甚至 可 以 高 达 每 三 行 逻辑 一 个 。 

然而 ， 不 论 你 如 何 决定 理想 的 比例 ， 我 认为 一 个 长 达 100 行 的 方法 其 实 没有 太 大 意义 。 
你 也 许可 以 将 其 分 成 3 个 或 4 个 小 一 些 的 方法 ， 并 于 弃 一 些 评论 。 

我 不 认为 自己 是 软件 度量 方面 的 专家 , 但 我 常常 会 将 我 的 方法 保持 在 30 行 以 内 一 一 这 多 
少 符 合 典 型 便携 式 电 脑 上 Visual Studio 编辑 器 中 的 显示 空间 。 如 何 保持 操作 方法 代码 的 短小 
精 悍 呢 ? 让 人 人 惊讶 的 是 ， 应 用 RDD 协调 器 是 必须 要 做 的 ， 但 仅 此 还 不 够 。 


注意 : 
我 分 解 代码 和 提高 可 读 性 所 遵循 的 快速 经 验 法 则 模式 是 ， 应 该 避免 使 用 正常 大 小 字体 编 
写 的 每 个 方法 需要 在 Visual Studio 窗口 中 深 动 才能 显示 完整 的 情况 。 


2. 作为 视图 模型 构造 器 编码 的 操作 方法 


被 设计 成 协调 器 的 方法 会 在 工作 线程 对 象 上 调用 一 个 方法 、 完 成 一 些 工 作 ， 然 后 取 回 一 
些 数据 。 这 些 数据 要 直接 冯 进 一 个 字典 或 强 类 型 的 类 ， 然 后 传 给 视图 引擎 。 

然而 ， 工 作 线 程 类 会 试图 在 中 间 层 上 的 数据 模型 一 一 即 域 模型 一 一 与 表示 层 中 的 数据 模 
型 一 一 即 视 图 模型 、 或 当前 在 视图 中 处 理 的 数据 之 间 做 桥接 (顺带 说 一 句 ,“ 当 前 在 视图 中 处 
理 的 数据 ”最 初 是 在 MVC 文件 中 用 来 定义 模型 角色 的 措 娠 )。 

如 有 果 在 中 间 层 调用 的 业务 对 象 返回 域 对 象 的 集合 或 聚集 ， 则 可 能 需要 将 此 数据 捏合 到 准 
确 表 示 约 定 用 户 界 面 的 视图 模型 对 象 中 。 如 果 把 这 项 任务 移 到 控制 器 类 中 , 就 义 回 到 原点 了 。 
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通过 使 用 工作 线程 服务 和 RDD 协调 器 原型 所 截取 抒 的 代码 行 ， 衫 大量 用 于 构建 视图 模型 的 
行人 得 换 了 了 。 
为 了 文 持 你 获得 精简 的 控制 右 ， 我 推荐 使 用 基于 以 下 这 几 点 的 集 略 : 
e 将 所 有 操作 传递 给 特定 于 控制 器 的 工作 线程 服务 类 (部 分 应 用 层 且 不 可 重用 )。 
使 工作 线程 服务 类 方法 能 接受 来 目 模型 绑 定 需 的 数据 。 
使 工作 线程 服务 类 方法 能 返回 表示 为 准备 传 给 视图 引擎 的 视图 模型 对 象 的 数据 。 
通过 特性 捕获 姬 。 
用 .NET 代码 约定 检查 先决 条 件 ， 并 在 合适 的 情况 下 确保 后 置 条 件 。 
对 于 其 他 任何 需要 额外 多 辑 的 情况 ， 请 考虑 使 用 目 定义 的 操作 筛选 器 。 
下 面 来 看 看 我 是 如 何 设想 实现 一 个 工作 线程 服务 类 的 。 


3. 工作 线程 服务 


工作 线程 服务 是 与 控制 器 密切 相关 的 一 个 帮助 器 类 。 可 以 合理 地 认为 每 个 控制 器 都 有 一 
个 不 同 的 工作 线程 服务 类 。 另 一 方面 ， 工 作 线 程 服务 只 是 控制 器 的 一 种 扩展 ， 并 产生 于 RDD 
协调 器 角色 所 推动 的 控制 器 行为 的 逻辑 分 离 。 

我 在 这 里 使 用 服务 一 词 是 要 表明 这 个 类 为 调用 方 提供 了 一 种 服务 ， 这 与 你 可 能 了 解 的 像 
Windows 通信 基础 (Windows Communication Foundation，WCF) 这 样 的 实现 服务 的 所 有 技术 无 
关 。 同 时 ， 如 果 决定 把 应 用 程序 层 扩展 到 多 台 计算 机 ， 那 么 WCF 就 是 将 逻辑 工作 线程 服务 
转变 成 实际 WCF 服务 的 绝 佳 技 术 。 

7-1 显示 了 ASPNET MVC 中 的 工作 线程 服务 的 架构 透视 图 。 


图 7-1 工作 线程 服务 与 控制 器 


工作 线程 服务 只 是 关于 设计 的 问题 ， 而 设计 就 是 设计 ， 无 关 其 复杂 性 。 所 以 ， 你 不 必 非 
得 等 到 一 个 大 型 项 目 才 可 以 余 A 。 让 我 们 通过 一 pe 
服务 方式 的 能 力 。 城 然 ， 对 一 个 简单 的 演示 来 说 它 可 能 显得 有 很 多 工作 要 做 ， 但 了 最终， 你 
只 需要 一 个 额外 的 接 ro Met 民 好 地 扩展 。 
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4. 实现 工作 线程 服务 


首先 可 以 在 ASPNET MVC 项 目 中 创建 一 个 Services 文件 夹 。 建 在 哪个 文件 夹 中 取决 于 
你 自己 。 我 通常 会 为 每 个 控制 器 配备 一 个 文件 夹 ， 外 加 一 个 额外 的 用 于 接口 的 文件 夹 。 图 7-2 
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图 7-2 ASPNET MVC 项 目 中 的 工作 线程 服务 


如 果 愿 意 ， 可 以 将 Services 天 分 移 到 一 个 单独 的 程序 集 一 一 这 取决 于 你 。 如 前 所 述 ， 可 
以 为 每 一 个 控制 器 创建 一 个 工作 线程 服务 。 对 于 Home 控制 器 ， 可 以 创建 IHomeService 接口 
和 HomeService 类 ， 如 下 所 示 : 


public interface IHomeService 


{ 
IndexViewModel GetIndexViewModel (); 

} 

public class HomeService : IHomeService 

{ 
private IHomesService homeService; 
public IndexViewModel GetHomeViewModel () 
{ 
} 

} 
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在 示例 应 用 程序 中 我 们 这 样 考虑 ， 首 页 选 出 一 个 特别 日 期 的 列表 ， 将 这 些 日 期 与 当前 日 
期 的 时 间 跨 度 按 天 数 呈 现 出 来 。 在 中 间 层 ， 使 用 一 个 返回 特别 日 期 相关 信息 的 存储 库 ， 比 如 
日 期 、 是 绝对 日 期 还 是 相对 日 期 (例如 ，2 月 8 日 ， 与 年 份 无 关 ) 以 及 对 日 期 的 说 明 。 下 面 是 一 
个 用 于 域 模型 的 特别 日 期 对 象 的 示例 : 


namespace FatrFree.Backend.Model 


{ 
public class MementoDate 
{ 
public DateTime Date { get; set; } 
public String Description { get; set; } 
public Boolean IsRelative { get; set; } 
} 
} 


存储 库 在 查询 一 些 数据 库 时 可 能 会 形成 这 些 对 象 的 一 个 集合 。 总 而 言 之 ， 工 作 线 程 服 务 
会 获得 一 个 MementoDate 对 象 集合 ， 并 对 其 进行 处 理 以 获得 一 个 FeaturedDate 对 象 集合 一 一 
一 种 属于 男 一 个 对 象 模型 ， 即 视图 模型 的 类 型 。 


namespace FatFree.ViewModels.shared 


{ 
public class FeaturedDate 
{ 
public DateTime Date { get; set; } 
public Int32 DaysToGo { get; set; } 
public String Description { get; set; } 
} 
} 


需要 完成 的 有 两 个 操作 : 讶 先 ， 任 何 相对 日 期 都 必须 转化 为 绝对 日 期 ， 第 二 ， 指 定 日 期 
与 当前 日 期 之 间 的 时 间 跨 度 必须 计算 出 来 。 例 如 ， 假 设 你 要 计算 现在 到 下 一 个 2 月 8 日 之 间 
的 路 度 。 如 采 正 在 计算 1 月 2 日 或 3 月 5 日 , 则 目标 日 期 就 是 不 同 的 。 下 面 是 工作 线程 服务 
中 的 一 部 分 代码 : 


private IDateRepository repository; 
public HomeViewModel] GetHomeViewModel () 
{ 
// Get featured dates from the middle tier 


Var dates = repository.GetFeaturedDates (); 


// Ad]ust featured dates for the view 
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/1 For example, calculate distance from now to specified dates 
Var featuredDates = new List<FeaturedDatesy ();，; 
foreach (var mementoDate in dates) 
{ 
var fd = new FeaturedDate 
{ 
Description = mementoDate.Description, 
Date = mementoDate.IsRelative 
? DateTime .Now.Next (mementoDate.Date.Month, 
mementoDate .Date .Day) 
: mementoDate.Date 
上 
fd.DaysToGo = (Int32) (DateTime.Now - fd.Date) .TotalDays; 
featuredDates .Add (fd).; 


// Package data into the view model as the view engline expects 


Var model = new HomeVliewModel 
{ 
Title = "Memento (BETA)™, 
MessageFormat = "Today 15 <span class= 


'dateEmphasis'>{0}</span>"™., 
Today = DateTime.Now.Tostring ("dddd, dd MMMM yyyy"), 
FeaturedDates = featuredDates 
}; 
return model; 


} 
那 控 制 器 又 如 何 呢 ? 下 面 就 是 你 需要 的 代 人 三: 
public ActionResult Index() 
{ 
Var model = homesService.GetHomeViewModel (); 


return View (model); 
} 


图 7-3 显示 了 运行 中 的 该 示例 页 面 。 
可 以 看 出 ， 工 作 线 程 服 务 背 后 并 没有 神奇 之 处 。 顾 名 思 义 ， 它 们 就 是 分 解 代码 的 工作 线 
程 类 而 已 ， 从 你 辑 上 讲 归属 于 请 求 的 处 理 器 一 一 ASPNET MVC 控制 器 。 
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Today is [nursday, 28 从 


. 27 1 days to Christmas. 
。 244 days since London Otympics kidk-off. 
. 8540 days since Bertin Wall collapsed. 


To leam more about Our services, visit expoware.org, 


7-3 工作 线程 服务 处 理 日 期 
5. 我 们 真 的 需要 控制 器 吗 


没有 哪个 控制 器 方法 的 代码 会 像 我 这 里 展示 的 那样 简单 一 一 只 有 一 行 逻辑 。 在 真实 的 场 
景 中 ， 你 可 能 需要 将 一 些 输入 数据 传递 给 工作 线程 服务 ; 也 许 你 会 使 用 站 语句 快速 排除 一 些 
情况 ， 或 者 进一步 编辑 视图 模型 对 象 。 后 一 种 情况 可 能 会 在 你 试图 获得 一 些 可 重用 性 和 一 个 
工作 线程 服务 方法 以 满足 两 个 或 多 个 控制 器 操作 方法 的 需求 时 发 生 。 

要 具体 化 操作 方法 中 的 代码 ， 可 以 使 用 异常 处 理 、null 检查 和 前 置 条 件 。 最 后 ， 为 了 保 
持 操作 方法 的 至 精 至 简 ， 还 要 将 RDD 协调 器 的 角色 发 挥 到 极限 ， 把 所 有 的 处 理 逻 辑 移出 控 
制 器 。 

这 是 否 意味 着 你 不 再 需要 控制 器 了 呢 ? 每 个 HITP 请 求 都 会 映射 到 一 个 操作 方法 ， 但 你 
需要 一 些 管 道 来 实现 这 些 连接 。 在 ASPNET MVC 中 ， 控 制 器 只 是 基础 架构 的 一 部 分 ， 它 不 
必 包 含 很 多 代码 ， 更 加 惊喜 的 是 ， 也 没有 必要 对 其 进行 测试 。 如 果 把 控制 器 看 作 是 基础 架构 
的 一 部 分 ， 自 然 会 认可 它们 的 基本 作用 ; 然而 ， 你 的 工作 线程 服务 却 需要 测试 (这 一 点 还 会 在 
第 9 章 “ASPNET MVC 中 的 测试 与 可 测试 性 ”中 涉及 ， 第 9 章 将 完全 致力 于 介绍 ASPNET 
MVC 应 用 程序 的 测试 )。 


6. 理想 的 操作 方法 代码 


让 我 们 通过 分 析 一 段 应 当 在 你 的 操作 方法 中 找到 的 理想 代码 片段 来 为 这 次 讨论 画 上 圆 
满 句号 。 它 使 用 特性 来 处 理 异 党 和 代码 约定 以 确定 先决 条 件 。 
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[HandleError(...}| 
public class DateController : Controller 
{ 
private readonly IDateService workerSsService; 
public DateController() : this (new DateService()) 
{ 
} 
public DateController (IDateService service) 
{ 
WorkerService = service; 


} 


[MementoInvalidDateException] 
[MementoDateExistsExcept1ion] 
[HttpPost] 
public ActionResult Add (DateTime date, String description) 
{ 
Contract.Requires<ArgumentException> (date > DateTime.MinValue); 
Contract.Requires<ArgumentExceptlion> 
(!String.IsNullOoOrEmpty (description); 


Var model = workerService.AddNewDate (date, description).; 
return View (model).; 


) 


在 此 示例 中 ， 目 定义 的 寞 党 特性 用 于 捕捉 可 能 由 工作 线程 服务 引发 的 特定 寞 第 。 在 这 种 
青 况 下， 你 不 必 使 用 站 语句 和 null 检查 来 损坏 你 的 代码 (我 并 不 反对 使 用 站 语句 ， 但 如 果 可 
以 为 自己 和 同事 节省 几 行 代码 ， 并 保持 代码 的 可 读 性 ， 那 么 我 肯定 会 选择 这 样 做 )。 


重要 提示 : 

如 果 你 是 一 个 细心 的 读者 ， 可 能 已 经 注意 到 了 ， 我 忽略 了 非 稼 重要 的 一 点 : 如 何 得 到 工 
作 线 程 服务 的 实例 。 以 及 反 过 来 ， 工 作 线 程 服务 如 何 得 到 存储 库 中 的 实例 ?在 代码 中 注入 依 
赖 性 的 技术 和 工具 正 是 下 一 个 话题 (第 8 章 ,“ 自 定义 ASPNET MVC 控制 器 ”涵盖 了 更 多 有 
关 在 整个 ASPNET MVC 框架 中 注入 点 和 相关 技术 的 信息 )。 


7.2 ”连接 表示 层 与 后 病 


假设 我 们 认同 你 不 在 控制 器 操作 方法 的 上 下 文中 编排 用 于 给 定 请 求 的 整个 逻辑 流程 这 


一 想法 ， 那 么 要 解决 的 下 一 个 问题 是 你 如 何 跨越 应 用 程序 表示 层 和 后 端 之 间 的 无 形 边界 ， 以 
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及 在 哪儿 路 越 。 图 7-1 中 的 细微 虚线 把 工作 线程 服务 块 与 应 用 程序 层 
顶层 阳 开 了 了 。 

作为 RDD 协调 器 实现 的 操作 方法 ， 它 会 迫使 你 把 请 求 转发 到 其 他 层 ， 但 在 条 些 点 上 你 
需要 越过 边界 去 调用 企业 服务 、 数 据 库 、 业 务 组 件 、 计 算 堪 以 及 你 可 能 有 的 其 他 任何 东西 。 
因此 ， 选 择 协 调 亏 路 由 对 你 如 何 组 织 下 行 层 和 应 用 程序 层 是 有 影 啊 的 。 


注意 : 

层 (layer) 和 层级 (tier) 这 样 的 术语 通 第 交 霄 使 用 ， 有 时 候 是 有 原因 的 。 但 是 ， 一 般 来 说 ， 
这 两 者 是 完全 不 同 的 实体 . 层 是 指 逻辑 上 的 分 离 , 比如 在 相同 的 进程 空间 引入 不 同 的 程序 集 . 
而 层级 的 是 物理 上 的 分 离 ， 例 如 ， 一 个 虽然 可 以 获取 到 的 软件 模块 ， 却 驻 留 在 不 同 的 进程 空 
间 ， 并 且 也 许 是 托管 在 不 同 的 硬件 /软件 平台 上 的 。 要 调用 一 个 层级 ， 需 要 厅 列 化 的 数据 、 协 
议 、 并 且 还 可 能 需要 如 .NET 空间 中 的 WCF 服务 技术 。 


7.2.1 分 层 架 构 模 式 


人 人 都 赞同 多 层 系统 在 可 维护 性 、 易 于 实现 性 、 可 扩展 性 、 可 伸缩 性 和 可 测试 性 方面 有 
着 诸多 优势 。 大 部 分 时 候 ， 你 要 设置 一 个 具有 各 种 服务 目标 的 三 层 架 构 ， 只 为 让 每 一 层 可 能 
移动 到 不 同 的 物理 层 。 把 逻辑 层 移动 到 自己 的 物理 层 上 可 以 有 许多 原因 : 需要 提高 可 伸缩 性 、 
需要 更 严格 的 安全 措施 ， 以 及 需要 提高 可 靠 性 以 防 逻 辑 层 因 计 算 机 故障 而 无 法 运行 。 

在 三 层 方 案 中 ， 通 党 有 一 个 表示 层 部 分 ， 先 负 员 人 处理 用 户 输入 然后 安排 啊 应 ; 有 一 个 业 
务 逻 辑 部 分 , 包括 所 有 的 函数 算法 和 计算 方法 , 使 系统 能 够 正常 工作 并 与 其 他 组 件 进行 交互 
还 有 一 个 数据 访问 部 分 ， 在 其 中 可 以 找到 从 存储 区 读 取 和 写 入 所 需 的 所 有 逻辑 。 

虽然 这 种 规划 总 体 而 言 坚 如 右 石 ， 但 是 根据 现 有 的 技术 、 研 究 成 果 和 业界 在 模式 和 人 解决 
方案 方面 取得 的 进展 来 看 ， 它 也 需要 进行 更 新 了 。 


1. 超越 经 典 层 


像 表 示 、 业 务 和 数据 访问 这 样 的 词 在 今天 来 看 ， 好 像 包 罗 万 象 ， 又 好 像 什么 都 不 是 ， 确 
实 变 得 相当 模糊 。 你 如 何 真正 地 设计 和 实现 它们 呢 ? 有 太 多 的 变量 ， 太 多 的 选择 、 模 式 和 做 
法 可 以 采用 。 接 下 来 接 述 的 分 层 染 构 模 式 就 试图 将 这 些 部 分 扩展 成 更 具体 的 东西 ， 并 为 实现 
的 过 程 所 供 指 导 。 

在 现代 软件 的 染 构 中 ， 你 会 发 现 表 示 层 、 应 用 程序 、 域 和 基础 染 构 这 些 层 。 图 7-4 提供 
了 一 个 分 层 染 构 的 概 贤 。 映 射 到 经 典 的 表示 + 业务 + 数据 层 是 相对 简单 的 。 经典 的 业务 层 第 常 
会 扩展 为 包罗 各 方面 的 内 容 一 些 表 示 层 的 内 容 、 一 些 基础 架构 的 内 容 以 及 整个 域 。 数 据 层 
位 于 基础 殿 构 中 。 这 样 做 其 实 只 是 为 了 重申 分 层 殿 构 不 是 什么 新 东西 ， 它 只 是 以 更 现代 和 务 
实 的 方式 应 用 那些 虽然 陈旧 但 仍 可 靠 的 理论 。 


应 用 程序 后 端的 最 
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这 里 就 是 大 多 数 令 人 感 
兴趣 的 内 容 发 生 的 地 方 ! 


图 1-4 分 层 架 构 示 例 


我 们 可 以 总 结 出 一 个 如 下 所 示 的 分 层 架 构 : 

表示 层 截获 请 求 并 将 其 传递 到 应 用 程序 层 。 应 用 程序 层 (也 称 为 服务 层 ) 是 应 用 程序 实现 
用 例 的 区 段 。 在 这 一 点 上 ， 它 特定 于 每 个 应 用 程序 并 且 不 可 重用 。 应 用 程序 层 将 端点 公开 给 
表示 层 ， 并 将 它 从 系统 的 其 他 部 分 解 厢 。 应 用 程序 层 会 安排 域 服务 和 外 部 服务 ， 以 及 可 能 
到 的 特定 业务 的 企业 组 件 。 最 后 ， 基 础 架构 层 会 封装 对 数据 的 访问 。 

注意 存储 并 不 一 定 是 关系 型 数据 库 。 现 在 ， 它 也 可 以 是 文档 数据 库 (NoSQL)、 云 数据 存储 
区 或 企业 客户 关系 管理 (CRM) 系 统 。 其 多 样 性 使 得 “数据 访问 ” 大抵 己 不 再 适合 用 来 描述 它 了 。 


2. (惯用 的 ) 表 示 层 
过 去 十 年 间 软 件 架 构 师 学 到 的 重要 经 验 是 ， 不 深入 客户 就 不 可 能 创建 成 功 的 应 用 程序 。 
早 在 2001 年 ， 这 就 在 “敏捷 宣言 ”中 作为 一 个 关键 点 被 提 及 ， 在 现实 中 ， 客 户 与 开发 团队 之 
间 的 协作 往往 在 于 当事人 的 良好 意愿 。 但 通常 的 情况 是 ， 协 同 合 作 只 是 一 个 大 家 并 不 会 全 力 
追求 的 良好 愿望 而 已 。 


如 今 ， 软 件 用 来 指导 用 户 尽 可 能 以 最 简单 有 效 的 方式 做 他 们 的 日 常 工作 。 软 件 必 须 转变 
成 用 户 所 期 望 的 ,而 不 是 反 过 来 一 一 像 过 去 多 年 的 情况 那样 。 我 记得 大 约 25 年 前 与 客户 进行 
过 一 次 讨论 ， 我 当时 丝毫 不 难为 情 地 说 ,“ 不 ， 这 个 功能 不 可 能 按照 你 所 建议 的 方式 编程 ,我 
们 使 用 的 语言 不 支持 这 个 。 ”这样 的 回答 在 今天 难以 想象 。 

无 论 你 采用 哪 种 技术 构建 应 用 程序 客户 端 ， 表 示 层 的 代码 部 分 都 负责 收集 来 自用 户 的 输 
入 数据 和 触发 预期 的 行为 。 如 果 应 用 程序 是 分 布 式 的 ， 则 表示 层 的 代码 段 负 贡 准 备 和 执行 远 
程 调用 以 及 在 结果 回来 后 安排 新 的 用 户 界面 。 重 要 的 一 点 是 ， 表 示 层 逻辑 调用 的 是 根据 用 户 
界面 (UD 需要 而 设计 的 方法 。 这 些 方法 接收 和 返回 为 UI 人 | 户 界 
面 接收 它 所 需要 的 ， 以 它 偏 好 的 形式 和 形态 。 无 论 你 碰 到 何 种 UI 技术 
浏览 器 、HTML5、 移 动 端 ”微软 Silverlight 等 ， 这 种 方法 都 会 使 你 :成 为 大 说 家 。 

面 对 实 现 的 时 候 ， 表 示 层 在 这 个 意义 上 必然 是 大 家 所 惯用 的 ， 即 实际 的 代码 取决 于 你 正 
在 使 用 的 框架 。 虽 然 总 体 概念 仍然 一 臻 ， 但 表示 层 在 Web Forms 中 是 基于 代码 隐藏 页 面 的 ， 
在 ASPNET MVC 中 是 基于 控制 器 (可 选择 性 地 加 上 工作 线程 服务 ) 的 ， 在 Silverlight 和 WPF 
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中 是 基于 模型 -视图 -视图 模型 (MVVM) 的 ， 等 等 。 例 如 ， 如 果 有 一 个 完全 的 客户 端 单 页 面 应 
用 程序 (SPA)， 你 会 希望 使 用 一 ee 框架 ,让 你 的 代码 和 g 够 使 用 MVC 和 MVVM 模式 。 

就 ASPNET MVC 而 言 ， 应 用 分 层 架 构 模 式 意 味 着 将 请 求 的 啊 应 结果 委托 给 工作 线程 服 
务 ， 接 着 ， 会 联系 后 端 获得 响应 。 啊 应 包含 了 表示 层 所 需 格 式 的 数据 。 


(设备 驱动 ) 用 户 体验 优先 

从 表示 层 开始 你 的 设计 已 经 日 益 变 得 重要 。 我 喜欢 把 这 种 方式 叫做 用 户 体 验 优 先 (User 
Experience First，UXF)， 也 希望 把 这 一 概念 与 设备 都 应 有 上 自己 量 身 定做 的 表示 层 的 想法 结合 
起 来 。 关 于 这 一 点 ， 我 会 在 第 13 章 “ 构 建 用 于 多 种 设备 的 站 点 ”中 阐述 。 

UXF 意味 着 你 :的 系统 设计 始 于 用 户 实际 交互 的 UI、 界 面 和 工作 流 。 由 于 软件 是 日 常 工 


作 必 不 可 少 的 工具 ， 需 要 考虑 的 优化 的 主要 形式 一 一 其 至 在 数据 库 之 前 一 一 是 在 用 户 级 别 的 
工作 流 中 消除 瓶 须 。 

定义 界面 以 后 (过 去 , 它们 只 是 定义 执行 者 和 系统 之 间 交 互 的 UML 用 例 图 ), 你 就 会 知道 
要 在 体系 架构 中 加 载 哪 些 数据 以 及 输入 哪些 数据 。 这 些 都 是 现代 架构 的 支点 。 


3. 应 用 程序 层 


应 用 程序 层 包含 用 例 的 实现 ， 可 以 将 其 看 作 起 编排 作用 的 组 件 的 聚合 。 这 里 的 编排 一 词 
指 的 是 服务 于 给 定 用 例 的 算法 实现 。 对 于 下 订单 用 例 来 说 ， 编 排名 是 安排 预期 数据 流 和 域 服 
务 ( 比 如 检查 信用 状况 和 回填 库存 )、 外 部 服务 (比如 与 运输 公司 进行 协同 )、 业 务 组 件 (计算 价 
格 )， 以 及 存储 (更 新 内 部 数据 库 ) 的 方法 。 

在 相对 简单 的 情况 下 ， wrend ton people 
能 会 与 应 用 程序 层 相 符 。 面 对 这 种 情况 时 ， 请 牢记 一 个 流行 的 面 同 服 务 染 构 (SOA) 的 警 
要 健壮 ， 不 要 繁杂 ( 见 图 7-5)。 


健壮 
单个 路 边界 调用 


繁杂 
多 个 路 边界 调用 


图 7-5 ASPNET MVC 中 健壮 编排 与 过 录 编排 的 对 比 
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如 果 编 排 的 服务 驻 留 ( 大 多 数 情况 下 ) 在 与 工作 线程 服务 相同 的 进程 空间 ， 你 或 许 就 不 必 
引入 男 一 个 屋 。 在 这 种 情况 下 ， 编 排 是 符合 工作 线程 服务 的 。 你 可 能 希望 将 工作 线程 服务 编 
译 成 一 个 单独 的 程序 集 ， 并 把 它们 的 逻辑 等 级 从 普通 的 帮助 右 类 升级 到 架构 构成 块 。 

如 果 要 编排 的 服务 是 远程 的 或 者 能 够 用 于 远程 ， 你 或 许 会 希望 在 要 编排 的 服务 的 空间 中 
引入 额外 的 编排 层 。 在 这 种 情况 下 , 你 要 从 工作 线程 服务 直接 以 单个 调用 转 到 这 个 额外 的 层 ， 
该 调用 会 将 各 个 步 又 所 需 的 所 有 数据 连接 在 一 起 。 从 为 一 个 层 一 一 表示 层 一 一 编排 则 会 在 分 


布 式 计算 、 序 列 化 和 网 络 延 迟 方面 耗费 你 的 成 本 。 这 就 是 反 楷 杂 模 式 的 SOA 设计 。 
4. 域 乓 


虽然 还 没有 正式 宣布 淘汰 ， 但 DataSet 对 大 部 分 开发 人 员 来 说 已 经 是 过 去 式 了 。 并 不 是 
DataSet 的 设计 有 毛病 ， 只 是 十 年 的 时 间 在 软件 行业 真 的 是 太 长 了 。 技 术 的 步伐 就 是 这 样 的 ， 
10 年 前 令 人 信服 的 解决 方案 在 下 一 个 十 年 很 难产 生 相同 的 效用 。 如 今 ， 实 体 框架 一 一 更 不 用 
提 NHibernate 和 其 他 商业 性 解决 方案 一 一 已 经 能 快速 创建 一 个 基本 的 域 模型 ， 围 绕 它 来 设计 
你 的 应 用 程序 了 。 可 以 利用 实体 框架 和 它 的 Visual Studio 工具 来 创建 实体 和 关系 ， 并 使 它们 
呈现 出 在 应 用 程序 的 眼中 真实 数据 库 的 模样 。 你 不 需要 成 为 域 驱动 设计 (Domain-Driven 
Design，DDD) 大 师 ， 也 可 以 保持 数据 库 详 细 信 息 不 同 于 用 来 实现 业务 操作 的 对 象 。 

现在 很 多 开发 人 员 发 现 创 建 实体 模 型 变 得 简单 有 效 ， 并 可 以 用 对 象 /关系 映射 器 (ORMD) 
工具 一 一 比如 实体 框架 或 NHibernate 将 实体 模型 持久 保存 。 

这 将 使 你 具有 一 个 带 有 填充 数据 和 行为 的 普通 旧式 CLR(POCO) 类 的 程序 集 。 此 对 象 模 
型 代表 了 你 在 应 用 程序 后 端 所 拥有 的 数据 模型 。 让 具有 描述 性 属性 的 类 ， 比 如 Customer， 在 
逻辑 上 等 效 于 某 些 数据 库 列 : Name、Address、Website、Email、Contact、Orders。 此 外 , Customer 
类 可 能 会 有 大 量 验 证 对 象 状态 的 方法 , 并 实现 特定 于 对 象 且 与 实例 相关 联 的 属性 值 上 的 操作 。 
例如 ， 你 可 能 有 一 个 方法 计算 与 客户 关联 的 订单 (Orders) 的 总 额 。 或 者 ， 对 于 具有 Date 和 
PaymentMode 属性 的 Invoice 类 ， 可 以 使 用 -个 返回 预计 付款 日 期 的 方法 。 在 这 个 对 象 模型 
中 ， 类 对 于 持久 性 和 连接 字符 串 之 类 的 事情 一 无 所 知 。 


注意 : 

对 其 模型 、 域 模型 和 实体 模型 是 常常 可 以 互 换 使 用 的 相似 术语 。 但 是 ， 每 个 术语 也 都 有 
自己 独特 的 含义 。 有 时 候 ， 没 有 到 使 用 精确 含义 的 地 步 时 ， 你 互 换 使 用 当然 没 错 。 然 而 ， 这 
种 非 正 式 的 用 法 并 不 会 抹杀 每 个 词 的 真正 含义 。 对 象 模型 是 普通 、 泛 型 的 对 象 集合 。 域 模型 
是 特殊 类 型 的 对 象 模型 ， 其 中 的 每 一 个 类 都 是 POCO、 聚 合 根 会 被 识别 出 、 工 厂 会 被 用 于 构 
造 函 数 、 并 且 大 多 数 时 候 值 类 型 往往 会 取代 基 元 类 型 .最 后 , 实体 模型 基本 上 是 一 个 表明 类 (大 
多 是 贫血 类 ) 的 集合 的 实体 框架 术语 ， 可 能 是 POCO， 也 可 能 不 是 。 贫 血 类 有 数据 ， 但 几乎 没 
有 行为 。 
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更 加 面 回 业务 的 行为 ， 比 如 检查 客户 的 信用 状况 或 验证 客户 是 否 下 了 足够 多 的 订单 以 获 
取 高 水 平 的 服务 或 奖励 。 并 且 更 主要 的 是 ， 那 些 生产 或 操作 跨 多 个 实体 且 需 要 访问 数据 库 的 
聚合 数据 的 功能 。 这 些 都 是 限于 域 实体 和 其 持久 性 的 编排 的 特殊 形式 。 需 要 你 通过 另 一 个 称 
为 域 服务 的 类 集合 来 实现 它们 。 你 可 能 有 用 于 各 个 重要 实体 的 域 服 务 组 件 或 者 ， 用 DDD 术 
语 来 说 ， 用 于 各 个 聚合 根 的 域 服务 组 件 。 域 模型 和 域 服务 组 成 了 域 层 。 


5. 公开 域 的 实体 


域 层 中 类 的 可 见 性 是 怎样 的 ?它们 应 该 出 现在 表示 层 中 ， 还 是 注定 要 在 后 并 系 统 层 中 存 
在 与 发 展 ? 如 果 人 们 可 以 在 任何 位 置 使 用 域 对 象 的 话 ， 那 么 开发 过 程 就 会 更 加 美好 。 如 果 你 
的 特定 情况 能 够 通过 使 用 一 个 对 象 模型 将 数据 围 纸 域 模型 移动 的 话 ， 那 你 就 一 定 要 庆幸 目 己 
辛 运 了 ， 就 这 么 做 吧 。 然 而 ， 事 实 上， 这 除了 会 在 会 议 演示 和 教程 中 出 现 ， 几 乎 从 来 不 会 出 
现在 现实 情况 中 。 

表示 层 是 围 纸 用 例 构 建 的 ， 并 且 每 个 用 例 对 实体 的 定义 都 可 能 会 有 所 人 不同。 订单 在 不 同 
的 用 例 中 可 能 有 不 同 的 表示 形式 ， 如 “用 户 发 出 了 订单 ”和 “用 户 检 枉 待 处 理 订单 ”有 了 时候 ， 
对 Order 实体 使 用 相同 的 基于 域 的 表示 形式 是 可 以 的 , 因为 不 同 的 用 例 只 需要 一 个 原始 Order 
的 子 集 。 但 通常 ， 每 个 用 例 需要 的 对 象 会 选择 一 些 来 自 原始 Order 的 信息 以 及 一 些 来 自 其 他 
实体 一 -例如 Products 的 信息 。 在 域 模型 中 ， 你 却 正好 没有 这 种 聚合 。 因 此 ， 必 须 创建 一 个 
专注 于 视图 的 对 象 模型 ， 并 把 数据 转移 到 其 中 以 及 从 其 中 转移 出 去 。 

专注 于 视图 的 对 象 模型 是 基于 数据 传输 对 象 (data-transfer objects，DTO) 的 。DTO 是 一 个 
普通 的 容器 类 (只 有 数据 ， 没 有 行为 )， 用 于 在 屋 、 层 级 之 则 其 或 同一 层 之 内 传递 数据 。 有 了 
DTO， 你 绝对 可 以 在 任何 位 置 使 用 你 所 需 的 数据 。 但 是 ， 知 易 行 难 。 基 于 DTO 的 解决 方案 
十 分 昂贵 ， 且 编码 阶段 也 比较 痛 苗 。 

要 应 对 DTO 的 额外 复杂 性 ,可 以 利用 像 AutoMapper(http://automapper.codeplex.com) 这 样 
的 工具 ， 使 你 免 于 编写 重复 的 (和 枯燥 的 ) 代 码 ， 或 者 可 以 使 用 T4 模板 来 保存 一 些 音 见 代 码 ， 
目 己 只 编写 目 定义 的 部 分 。 


6. 基础 架构 层 


如 何 得 到 一 个 对 域 对 象 的 引用 呢 ? 一 般 情 况 下 ， 域 对 象 可 以 是 瞬 态 的 也 可 以 是 持久 的 。 
如 果 一 个 新 的 实例 创建 于 内 存 中 ， 并 以 运行 时 数据 填充 ， 我 们 就 说 它 是 瞬 态 的 。 如 果实 例 包 
含 从 存储 区 读 取 的 数据 ， 我 们 就 说 它 是 持久 的 。 当 你 要 插入 一 个 新 的 订单 ， 通 常 处 理 的 是 瞬 
态 实 体 ; 当 你 从 存储 区 获取 订单 用 于 显示 或 处 理 时 ， 你 处 理 的 就 是 持久 实体 。 

基础 架构 层 基 本 上 天 是 数据 库 层 ， 重 命名 后 降低 了 放 在 数据 和 模型 上 的 焦点 和 重点 。 在 
现代 系统 中 ， 仍 然 需要 持久 性 ， 但 这 不 一 定 来 自 于 关系 模型 ， 也 仅 限 于 原始 数据 的 存储 ， 所 
有 一 切 ( 例 如 ， 约 束 、 验 证 、 操 作 ) 痢 在 系统 的 更 局 层 上 发 生 。 
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因此 ， 基 础 以 构 层 处 理 持久 性 ， 它 由 存储 库 类 构成 ， 每 个 重要 实体 (或 者 ， 也 可 以 称 为 聚 
合 根 ) 配 有 一 个 。 存储 库 类 使 用 一 个 指定 的 存储 API 来 实现 持久 性 。 存储 库 类 的 实现 在 逻辑 上 
属于 数据 访问 层 。 存 储 库 关 会 聚集 多 个 服务 于 实体 数据 访问 需求 的 方法 。 在 存储 库 中 ， 通 和 
可 以 找到 读 取 、 添 加 、 删 除 和 更 新 数据 的 方法 。 

存储 库 问 应 用 程序 层 公 开 接 口 并 在 内 部 使 用 存储 API。 因 此 ， 可 以 有 一 个 使 用 实体 框架 
和 POCO 模型 的 存储 库 ， 或 者 一 个 使 用 NHibernate 的 存储 库 。 也 可 以 通过 一 个 普通 的 
ADO.NET 层 将 存储 库 驻 留 在 域 中 。 还 可 以 将 存储 库 指 问 一 些 云 存 伴 、Dynamics CRM 或 
NoSQL 服务 。 在 每 个 实体 的 基础 上 (确切 地 说 ， 只 是 主要 实体 ) 创 建 的 存储 库 是 通 往 实 际 持久 
层 的 大 门 。 

使 用 存储 库 之 所 以 重要 还 有 一 个 原因 一 一 通过 模仿 持久 层 让 你 的 业务 服务 具备 可 测试 性 。 

存储 库 类 的 典型 结构 是 什么 ?这 就 涉及 两 个 主要 流派 。 一 部 分 人 更 愿意 使 用 一 个 通用 的 
存储 库 ， 为 每 个 实体 提供 基本 的 CRUD 方法 ， 如 下 所 示 : 

public abstract class Repository<T> where T : IAggregateRoot 

{ 


internal YourContext ActiveContext { get; set; } 
public Repository() 


{ 

ActiveContext = new YourContext (}; 
} 
public vol1d Add (T item) 


this.Addopbpject (1Item) ; 
this.ActiveContext .SaveChanges (); 


} 
public bool Remove(T litem) 
{ 
try { 
this.DeleteObject (1Item) : 
this.ActiveContext.SaveChanges () ; 
return true; 
} catch { 
return false; 
} 
} 
public vold Update (T item) 
{ 
this.ActiveContext .SaveChanges () ; 
} 
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就 香 询 而 言 ， 下 面 是 一 个 可 能 会 在 通用 存储 库 类 中 看 到 的 方法 列表 : 


T[] GetAll<T>(); 

T[] GetAll<T> (Expresslion<Func<T, bool>> filter); 

T GetSingle<T> (Expresslion<Func<T, bool>> filter); 

传递 该 查询 的 详细 信息 以 通过 GetAll 或 GetSingle 将 该 查询 作为 一 个 函数 来 执行 。 

男 一 部 分 人 则 倾 加 于 直接 使 用 一 个 常规 的 存储 库 类 ， 其 中 包含 要 实现 的 逻辑 所 要 求 的 多 
个 方法 。 在 这 种 情况 下 ， 最 终 会 发 现 那 是 一 个 量 里 定做 的 实体 类 。 可 轻松 地 正确 处 理 删 除 和 
插入 操作 的 特殊 情况 ， 并 使 用 一 个 特定 的 get 方法 来 调用 每 个 必要 的 但 询 。 最 终 的 选择 决定 
于 你 ， 因 为 没有 哪 一 个 方法 明显 优 于 其 他 的 方法 。 就 个 人 而 言 ， 我 喜欢 有 特定 的 ( 非 泛 型 ) 存 
储 库 。 


注意 : 

谈 到 存储 库 ， 还 要 提 到 一 点 。 如 果 使 用 O/RM 保留 数据 的 话 ， 它 就 关系 到 上 下 文 对 象 的 
生命 周期 。 在 前 面 的 代码 清单 中 ， 你 看 见 了 一 个 ActiveContext 属性 被 构造 函数 实例 化 。 用 这 
种 方法 ， 上 正文 的 生命 周期 会 与 实例 一 样 长 。 对 相同 实例 的 多 次 调用 可 以 享有 相同 的 身份 映 
射 ， 且 可 以 跟踪 更 改 。 一 个 替代 方法 是 使 用 会 在 每 个 存储 库 操 作 结 束 时 丢弃 的 局 部 范围 实例 。 


7.2.2 在 层 中 注入 数据 和 服务 


使 用 层 ( 和 层级 ) 的 主要 原因 是 SoC。 作 为 染 构 师 ， 你 要 确定 哪些 层 之 间 相 互联 系 ， 并 且 
要 让 测试 、 代 码 检查 、 也 许 还 有 签 入 策略 来 强制 执行 这 些 规则 。 然 而 ， 即 使 有 两 个 层 预 期 要 
协作 ， 你 也 不 会 想 让 它们 么 耦合 。 在 这 方面 ， 依 顿 反 转 原 则 (回顾 本 重 前 面部 分 ， 这 是 SOLID 
首 字 母 缩写 中 的 “D”) 能 带 来 帮助 。 我 甚至 说 过 依赖 反 转 原则 比 依赖 注入 模式 更 为 重要 ， 现 
在 似乎 人 人 都 这 样 想 了 。 


1. 依赖 反 转 原则 


如 其 定义 ， 依 赖 反 转 原 则 (DIP) 规 定 高 级 别 的 类 不 应 依赖 低级 别 的 类 。 作 为 得 代 ， 高 级 别 
的 类 应 该 总 是 依赖 于 它们 所 需 低级 别 类 的 抽象 。 在 某 种 程度 上 ， 这 一 原则 是 面 问 对 象 设 计 文 
柱 之 一 的 一 个 特殊 化 ， 编 程 为 一 个 接口 ， 而 非 一 个 实现 。 

DIP 是 以 目 上 而 下 方式 的 形式 来 定义 所 有 重要 关 方 法 的 行为 。 在 这 种 目 上 而 下 方式 的 使 
用 过 程 中 ， 你 要 专注 在 发 生 于 方法 级 别 的 工作 流 上 ， 而 非 其 特定 依赖 性 的 实现 上 。 然 而 在 茶 
种 程度 上 ， 低 级 别 的 类 应 该 连接 到 主流 代码 上 。DIP 表明 这 要 通过 注入 来 实现 。 

在 某 种 程度 上 ， 任 何 时 候 面 对 一 个 依赖 性 时 ，DIP 都 会 表示 一 个 控制 流 的 反 转 一 一 只 要 
主流 程 有 权 访 问 依 赖 性 的 抽象 ， 它 就 不 会 去 关注 依赖 性 的 细节 。 然 后 依赖 性 会 在 必要 的 时 
候 以 某 种 方式 注入 。 图 7-6 显示 了 一 个 用 于 DIP 典型 示例 的 经 典 图 的 个 性 化 版 本 ， 最 早 由 
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Robert Martin 在 他 的 论文 中 提出 ,可 以 在 http://www.objectmentor.comy/resources/articles/dip.pdf 
处 找 到 已 


FileReader 


图 7-6 DIP 图 表 


该 论文 介绍 了 一 个 示例 Copy 函数 ， 从 一 个 源 读 取 并 写 入 到 目标 流 。 该 Copy 函数 理论 上 
不 关注 读 取 器 和 写 入 器 组 件 的 详细 信息 。 它 应 该 只 会 关心 读 取 器 和 写 入 器 的 接口 。 之 后 读 取 
锅 和 写 入 器 被 注入 ， 或 围绕 着 Copy 函数 的 实现 以 菜 种 方式 解析 。 这 一 点 如 何 处 理 取决 于 你 
打算 使 用 的 实际 模式 。 

要 处 理 DIP， 通 第 可 以 使 用 两 种 模式 : 服务 定位 器 模式 和 依赖 注入 模式 。 


2. 服务 定位 器 模式 


服务 定位 器 模式 定义 了 一 个 组 件 ， 它 知道 如 何 检索 应 用 程序 可 能 需要 的 服务 。 调 用 方 天 
须 指 定 具 体 的 类 型 ， 调 用 方 通 前 表示 接口 、 基 类 型 或 者 是 以 字符 串 或 数字 编码 形式 存在 的 服 
务 昵称 。 

服务 定位 器 模式 会 隐藏 组 件 香 找 的 复杂 性 ， 处 理 缓存 或 实例 池 ， 一 般 情 况 下 ， 会 提供 一 
个 组 件 查 找 和 创建 的 常见 外 观 。 下 面 是 一 个 服务 定位 器 的 典型 实现 : 

public class ServiceLocator 

{ 

private static const String SERVICE QUOTEPROVIDER = "quoteprovider"; 


// You might also want to have a generic method GetService<T>()... 
public static Object GetServlce (Type 七 ) 


{ 
if (七 == typeof (IQuoteProvider)) 
{ 
return new SomeQuoteProvider () ; 
} 
} 


public static Object GetService (String serviceName) 


{ 
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swlitch (serviceName) 


{ 
Case SERVICE QUOTEPROVIDER: 
return new SomeQuoteProvider ()， 


} 

正如 你 所 看 到 的 ， 定 位 器 仅仅 是 对 知道 如 何 获得 指定 (或 间接 引用 的 ) 类 型 实例 的 Factory 
对 象 的 一 个 封装 。 我 们 现在 来 看 看 调用 定位 器 的 代码 。 下 面 的 代码 揭示 了 一 个 类 ， 这 个 类 首 
先 为 指定 的 符号 列表 获取 引用 ， 然 后 加 一 个 HTML 字符 串 呈 现 其 值 : 


public class FinanceInfoSsService 


{ 
public String GetQuotesAsHtml] (String Symbols) 
{ 
// Get dependencies 
var renderer = ServiceLocator.GetService ("gquoterenderer"); 
Var provider = ServiceLocator.Getservice ("quoteprovider"); 


// Use dependencies 
Var stocks = provider.FindQuoteInfo (Symbols) ; 
var html = renderer.RenderOQuoteInfo(stocks); 


return html; 
} 

} 

定位 器 代码 存在 于 管理 抽象 的 方法 内 ， 工 厂 是 协议 的 一 部 分 。 只 查看 FinanceInfoService 
类 的 签名 ， 你 并 不 能 获知 它 是 否 在 外 部 组 件 上 有 依赖 性 。 必 须 检 查 GetQuotesAsHtml 方法 的 
代码 将 其 找 出 来 。 

服务 定位 器 的 重点 是 实现 组 件 之 间 的 最 低 可 能 耦合 度 。 定 位 器 代表 了 应 用 程序 用 来 获得 
其 所 需 所 有 外 部 依赖 性 的 集中 控制 台 。 这 样 的 话 ， 服 务 定位 器 模式 也 就 会 产生 令 人 愉快 的 意 
外 结果 ， 增 加 你 代码 的 灵活 性 和 可 扩展 性 。 

使 用 服务 定位 器 模式 从 纯粹 功能 的 角度 来 说 不 是 一 件 坏事 。 然 而 ， 在 实际 中 存在 看 更 好 
的 选择 : 依赖 注入 模式 。 

3. 依赖 注入 模式 

服务 定位 副 和 依赖 注入 的 最 大 区 别 是 ， 使 用 依赖 注入 ， 工 三 代 公 存在 于 正在 运行 的 类 之 
外 。 该 模式 表明 你 要 以 这 样 一 种 方式 设计 类 : 它 从 外 部 接收 其 所 有 依赖 性 。 下 面 是 如 何 重 写 
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FinanceInfoService 类 以 使 用 依赖 注入 模式 的 代码 : 


public class FinancelInfoService 

{ 
private IQuoteProvider provider; 
private IRenderer renderer; 


public FinanceInfoService (IQuoteProvider provider, IRenderer renderer) 
{ 


provider = provider; 


renderer = renderer:; 


} 


public string GetQuotesAsHtml] (string Symbols) 


{ 
var stocks = provider.FindQuoteInfo(symbols); 
string html = renderer.RenderQuoteInfo(stocks); 
return html; 

} 


} 

在 类 中 使 用 依赖 注入 的 时 候 ， 开 发 人 员 必 须 作 出 的 一 个 关键 决定 是 ， 如 何以 及 在 何 处 让 
代码 注入 。 有 三 种 方式 可 以 把 依赖 性 注入 到 类 中 ， 使 用 构造 函数 、 一 个 可 设置 的 属性 、 或 一 
个 方法 的 参数 。 这 三 种 方式 都 有 效 ， 最 终 的 选择 取决 于 你 。 一 般 的 共识 是 将 构造 函数 用 于 必 
要 的 依赖 性 ，setter 方法 用 于 可 选 的 依赖 性 。 然 而 ， 仍 有 一 些 注意 事项 。 

如 果 有 很 多 依赖 性 呢 ? 在 这 样 的 情况 下 ， 你 的 构造 函数 看 起 来 会 非常 混乱 。 虽 然 构造 函 
数 中 的 一 长 串 参 数 通 党 是 某 些 设计 问题 的 标志 ， 但 这 也 不 是 一 个 便 性 规定 。 你 可 能 会 过 到 复 
森 构 造 冰 数 有 很 多 参数 的 情况 。 这 时 , 将 依赖 性 分 组 到 复合 对 象 是 一 个 解决 方 膝 。 简 而 言 之 ， 
你 的 目标 应 该 是 在 构造 时 揭示 依赖 性 和 意图 。 可 以 有 两 种 方式 达成 这 一 点 : 通过 一 套 经 典 的 
构造 函数 ， 你 归 设 法 傈 持 其 尽 可 能 的 简单 ， 或 者 通过 工厂 。 

工厂 是 DDD 方法 的 首选 方式 。 使 用 工厂 ， 可 以 将 所 需 类 型 实例 的 上 下 文 表达 得 更 清楚 。 
也 可 以 在 工厂 代码 内 处 理 依赖 性 ， 并 确保 从 一 开始 即 返回 有 效 的 对 象 。 此 外 ， 你 的 类 最 终 只 
会 有 上 默认 的 构造 函数 (可 能 作为 受 保护 的 成 员 实现 )。 

使 用 构造 函数 也 会 妨碍 继承 关系 ， 因 为 派生 的 类 可 能 也 需要 接收 依赖 性 。 当 你 添加 一 个 
新 的 依赖 性 时 ， 设 计 方 案 可 能 需要 更 多 的 重 构 工 作 。 

然而 ， 当 依赖 性 是 可 选项 的 时 候 ， 并 不 会 严格 要 求 在 构造 函数 层面 显示 该 依赖 性 。 这 时 ， 
使 用 setter 属性 就 好 ， 而 且 很 有 可 能 这 就 是 推荐 的 方法 ， 因 为 它 有 助 于 保持 构造 函数 (或 工厂 
代码 ) 的 简洁 。 
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总 之 ， 使 用 构造 函数 和 使 用 setter 属性 都 有 各 目的 理由 。 与 许多 其 他 以 构 问 题 一 样 ， 正 
确 的 答案 是 ,“ 看 情况 ”。 它 也 取决 于 你 的 个 人 豆 好 。 


4. 用 于 探 制 反 转 的 工具 


DI 会 将 所 有 涉及 依赖 性 设置 的 代码 从 类 中 除去 。 当 依赖 性 租 套 时 ,代码 可 能 会 有 许多 行 
的 长 度 ; 而 且 ， 大 部 分 都 是 样板 代码 。 为 此 ,开发 人 员 创 建 了 称 为 控制 反 转 (IoC) 的 特 设 框架 。 
IoC 容器 是 一 个 专门 创建 用 来 支持 DI 的 框架 。 可 以 认为 它 是 能 迅速 有 效 实现 DI 的 生产 力 工 
具 。 从 应 用 程序 的 角度 看 ， 容 器 是 一 个 富 工 厂 ， 提 供 对 要 检索 的 且 以 后 要 使 用 的 外 部 对 象 的 
访问 权 。 

所 有 的 IoC 框架 都 是 围绕 一 个 容器 对 象 构建 的 ， 当 该 容器 对 象 绑 定 到 某 些 配置 信息 时 ， 
它 就 会 解析 依赖 性 。 调 用 方 代码 会 将 该 容器 实例 化 ， 并 将 所 需 的 接口 作为 参数 传递 。 在 响应 
中 ，IoC 框架 会 返回 一 个 实现 该 接口 的 具体 对 象 。IoC 容器 持 有 一 个 类 型 映射 字典 , 通常 会 将 
一 个 抽象 类 型 (比如 接口 ) 映 射 到 一 个 具体 的 类 型 或 指定 具体 类 型 的 一 个 实例 。 表 7-3 列 出 了 
一 些 目 前 可 用 的 最 流行 的 IoC 框架 。 


表 7-3 流行 的 1oC 框 淋 


框 如 URL 
Autofac http://code.google.com/p/autofac 
Castle Windsor http://www.castleproject.org/container/index.html 
Ninject http://www.ninject.org 
Spring.NET http://www.sprineframework.net 
StructureMap http://structuremap.net/structuremap/index.html 
Unmty http://unity.codeplex.com 


对 其 配置 以 后 , IoC 容器 使 你 可 以 用 一 个 调用 就 解决 你 类 型 之 间 整 个 依赖 关系 链 的 问题 。 
此 外 ， 为 你 省 去 了 内 在 依赖 性 的 各 种 复杂 问题 。 例 如 ， 如 果 在 类 的 构造 函数 或 属性 中 有 一 些 
ISomeService 参数 ， 就 肯定 可 以 在 运行 时 得 到 它 ， 只 要 你 指示 IoC 容器 来 解析 它 。 此 方法 的 
优点 是 ， 如 果 映 射 到 ISomeService 的 具体 类 型 构造 函数 有 其 自 喘 的 依赖 性 ， 这 些 也 都 会 自动 
解析 。 

你 会 更 进一步 发 现 . 使 用 IoC 容 堪 ， 便 不 用 再 担心 依赖 性 市 来 的 问题 。 另 外 ， 你 只 需要 
使 用 IoC 所 文 持 的 语法 来 设计 依赖 性 图 表 就 可 以 了 。 其 他 一 切 都 不 用 再 操心 了 。 

IoC 容器 在 其 所 文 持 的 语法 (比如 lambda 表达 式 )、 使 用 的 配置 策略 (比如 外 部 XML 方案 )， 
以 及 可 用 的 附加 功能 方面 会 有 所 不 同 。 有 两 个 特征 如 今 的 重要 性 很 高 , 即 : 面 同方 面 的 能 力 ( 具 
体 来 说 就 是 拦截 ) 和 促进 与 WCF 服务 集成 的 专用 模块 。 
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注意 : 

关于 Unity( 微 软 的 IoC 库 )， 你 发 现 其 中 书 舍 有 高 级 功能 ， 巴 括 我 在 MSDN 灯 记 的 前 沿 
专栏 中 提 到 过 的 拦截 功能 ; 具体 来 说 是 在 2011 年 1 月 /2 月 的 那 一 期 。 可 以 在 
http://blogs.microsoft.co.il/blogs/gadib/archive/2010/11/30/wcf-and-unmity-2-0.aspx 处 找到 一 篇 精 
彩 的 文章 ， 它 可 以 帮助 你 了 解 如 何 使 用 Unity 在 WCE 服务 的 初始 化 过 程 中 注入 依赖 性 。 


5. 穷人 的 D| 


如 今 ， 人 们 往往 把 依赖 注入 模式 与 使 用 IoC 框 染 混为一谈 。 使 用 IoC 框 染 是 关于 生产 率 
的 问题 ; 因而 ， 它 通常 需要 最 低 临 界 值 的 复杂 度 以 变 得 真正 有 效 。 在 简单 的 情况 下 ， 可 以 选 
择 所 谓 的 穷人 DI。 可 以 回 看 图 7-3， 在 FatFree 示例 的 源 代 码 中 找到 有 关 这 种 技术 的 例子 。 

你 将 如 何在 控制 右 类 注入 一 个 工作 线程 服务 ， 又 如 何在 工作 线程 服务 中 注入 存储 库 呢 ? 
最 明显 的 方法 是 让 控制 器 和 工作 线程 服务 创建 一 个 新 的 依赖 对 象 的 实例 。 但 是 ， 此 路 由 创建 
的 是 一 个 对 象 之 间 的 紧密 依赖 ， 却 阻碍 了 可 扩展 性 和 可 测试 性 。 这 里 有 一 个 更 好 的 办 法 : 

public class HomeController : Controller 

{ 


private readonly IHomeService workerSsService; 
public HomeController() : this (new HomeService()) 


{ 
} 
public HomeController (IHomeService service) 
{ 
WorkerService = service; 
} 


} 


当 使 用 默认 的 构造 函数 实例 化 一 个 控制 器 时 ， 工 作 线 程 服务 成 员 会 指向 一 个 新 创建 的 默 
认 工 作 线 程 服务 类 的 实例 。 第 二 个 构造 函数 可 用 于 手动 注入 你 想 要 注入 的 实例 ， 至 少 是 出 于 
可 测试 性 的 原因 。 同 样 ， 在 工作 线程 服务 中 注入 存储 库 依赖 也 是 同样 的 过 程 。 

然而 ，ASPNET MVC 通常 会 将 默认 的 构造 函数 用 于 每 个 控制 嚣 类， 除非 你 获得 了 对 控 
制 器 工厂 的 控制 权 。 


注意 : 

ASPNET MVC 设计 有 几 个 扩展 点 ,但 它 通 第 缺乏 对 DI 的 全 面 支持 。 服 务 定位 器 通过 添 
加 新 的 扩展 点 ， 可 能 是 使 现 有 框架 能 更 松散 地 耦合 在 一 起 的 最 有 效 的 方式 ， 因 为 它 是 侵入 性 
最 小 的 解决 方案。 服务 定位 器 充当 了 黑 盒 的 角色 ， 你 把 它 安 闭 在 一 个 特定 点 ， 并 让 它 知晓 需 
要 什么 协议 以 及 如 何 得 到 它 。ASPNET MVC 有 自己 的 服务 定位 器 模型 ， 称 为 依赖 解析 器 ， 
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我 将 在 第 8 章 中 讨论 它们 。 
7.2.3 ”获得 对 控制 部 工厂 的 控制 权 

在 ASPNET MVC 中 , 控制 器 类 的 实例 化 是 一 个 受 关 注 的 时 刻 。ASPNET MVC 基础 架构 
包括 一 个 工厂 ， 该 工厂 使 用 所 选 控制 器 类 的 默认 构造 函数 。 如 果 控制 器 类 上 有 参数 化 的 构造 
图 数 ， 并 且 需 要 传 入 一 些 数 据 呢 ? 这 种 情况 没有 现成 的 文 持 可 用 ， 但 ASP.NET MVC 民 好 的 
可 扩展 性 设计 为 你 提供 了 一 个 挂钩 ， 可 以 用 你 自己 的 工厂 取代 默认 的 控制 器 工厂 。 

蕉 换 上 默认 控制 器 工厂 的 一 种 常见 方法 是 在 其 中 集成 一 个 IoC 容器 ， 这 样 就 可 以 通过 得 看 
注册 类 型 表 来 完美 地 解析 任何 参数 。 接 下 来 的 几 市 内 容 会 介绍 如 何 去 实 现 的 问题 。 

1. 注册 一 个 自 定义 控制 器 工厂 

首先 要 在 Application Start 中 注册 你 自己 的 控制 器 工厂 。 控 制 器 工厂 是 实现 
IControllerFactory 接口 的 类 。 要 注册 这 个 工厂 ， 你 要 按照 ASP.NET MVC 推行 的 新 模式 创建 
一 个 适当 的 配置 类 (当然 其 他 的 方法 也 不 错 )。 

protected vold Application Start () 

{ 


// Redlster a custom controller factory 
ControllerConfig.RegisterFactory (ControllerBRBuilder.Current); 


} 
ControllerConfig 类 是 一 个 市 有 静态 方法 的 简单 类 ， 如 下 所 示 : 
public static vold RegisterFactory (ControllerBuilder builder) 
{ 
Var factory = new UnityControllerFactory(); 


builder.SetControllerFactory (factory); 
} 


让 我 们 从 内 部 了 解 一 下 控制 右 工 三。 
2. 构建 一 个 自 定义 控制 颖 工厂 


典型 的 控制 器 工厂 类 继承 自 DefaultControllerFactory， 并 重 写 了 一 些 方法 ， 详 情 如 表 7-4 
所 示 。 
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表 7-4 流行 的 IoC 框架 


可 重 写 的 万 法 摘 。” 述 
CreateController 官 理 控制 器 实例 的 创建 。 它 需 要 控制 颖 的 名 称 (例如 , home) 并 且 返 回 控 


制 器 实例 。 默 认 实 现 首先 会 调用 GetControllerType 将 控制 器 名 称 映射 
到 类 型 并 随后 调用 GetControllerInstance 实际 创建 实例 


GetControllerInstance 获取 控制 占 类 型 以 及 请 求 上 下 文 ， 并 返回 新 创建 的 控制 占 实 例 
GetControllerSessionBehavior 获取 控制 右 类 型 的 会 话 状态 行为 。 


注意 : 如 果 想 要 编程 控制 会 话 状 态 行 为 确定 的 方式 ? 可 以 重 与 这 个 方 
法 。 上 默认 情况 下 ， 它 是 由 SessionState 特性 控制 的 

GetControllerType 葡 取 控制 占 名 称 及 请 求 上 下 文 并 返回 控制 器 的 预期 类 型 。 
注意 : 如 有 果 不 豆 欢 控制 器 类 型 呈 是 由 “Controller” 之 前 的 名 称 指定 这 
一 惯例 的 话 ， 可 以 重 与 这 个 方法 

ReleaseController 当 放 工控 制 占 实例 时 ， 执 行 消除 任务 


注意 ，CreateController 和 ReleaseController 方法 是 公共 的 ; 其 他 的 所 有 方法 都 是 受 保 护 
的 。 创建 自己 的 工厂 也 使 你 可 以 在 新 创建 的 控制 器 实例 上 执行 任何 类 型 的 自 定义 工作 。 例如 ， 
你 可 能 想 要 集中 初始 化 一 些 自 定 义 属性 (如 果 从 一 个 基 类 派生 控制 器 的 话 )。 更 有 可 能 的 是 ， 
你 可 能 想 要 使 用 这 个 挂钩 为 控制 器 实例 提供 一 个 手工 的 操作 调用 程序 (我 会 在 第 8 章 中 讨论 
操作 调用 程序 )。 


3. 基于 Unity 的 控制 希 工 三 


当 引 入 一 个 基于 Unity 的 目 定 义工 三 时 ,至少 你 会 想 要 重 写 GetControllerInstance 以 使 用 
Unity 基础 染 构 来 解析 控制 器 类 型 ， 如 下 所 示 : 


public class UnityControllerFactory : DefaultControllerFactory 
{ 


public static IUnityContainer Container { get; private set; } 


public UnityControllerFactory () 

{ 
Container = new UnityContainer (); 
Container.LoadConfiguration (); 


} 


protected override IController GetControllerIinstancel 
RequestcCcontext requestContext, Type controllerType) 
| 
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if (controllerType == null) 
return null; 
return Container.Resolve (controllerType) as IController; 


} 

使 用 Unity 引擎 保证 了 植 根 于 控制 器 类 型 的 进一步 依赖 性 得 以 识别 和 解析 。 参 照 FatFree 
的 例子 ， 这 正 古 工作 线程 服务 和 日 期 存储 库 依 赖 性 的 情况 。 

刚才 所 示 的 代码 看 起 来 是 非常 通用 ， 这 也 是 IoC 工具 最 终 变 得 如 此 成 功 的 原因 。IoC 工 
具 提 高 了 生产 力 ， 因 为 它们 为 你 节省 了 大 量 的 样板 代码 。 但 是 详细 信息 在 哪里 呢 ? 

就 像 其 他 任何 IoC 框架 一 样 ，Unity 需要 一 些 配 置 数 据 。 可 以 在 web.config 文件 中 配置 
这 些 数据 ， 也 可 以 使 用 Unity API 以 编程 方式 添加 。 归 根 结 底 ， 这 些 配置 数据 包括 了 指定 哪 
个 接口 类 型 映射 到 哪个 具体 类 型 ， 以 及 在 哪里 找到 这 些 类 型 。 下 面 是 一 个 包含 Unity 节 的 修 
改过 的 web.config 文件 : 


<configuration> 
<configSections> 
<section name="unity™" type="Microsoft.Practices.Unity.Configuration. 
UnityConfigurationSsection, 
Microsoft.Practices.Unity.configuration, ...™ /> 


</configSections> 


<unity xmlns="http://schemas.microsoft.com/practices/2010/unity"> 
<dssembly name="FatFreeIoC™" /> 
<namespace name="FatFreelIoC.Backend.DAL™" /> 
<namespace name="FatFreelIoC.Services.Abstractions"™" /> 
<namespace name="FatFreeloC.Services.Home™" /> 


<container> 
<reglster type="IHomeService™" mapTo="HomeService"> 
</reglster> 
<reglster type="IDateRepository" mapTo="DateRepository"> 
</reglister> 
</container> 
</unity> 
</configuration> 
名 称 空间 条 目 会 注册 一 个 Unity 用 来 限定 类 型 的 名 称 空间 。 程 序 集 条 目 列 出 了 被 认为 会 
解析 类 型 的 程序 集 。 在 容器 组 内 ， 可 以 注册 类 型 。 注 册 节 点 可 以 包含 很 多 子 节 点 ， 为 注入 和 


拦截 提供 额外 信息 (这 些 内 容 不 属于 本 书 范 畴 。 要 获知 相关 信息 ， 请 在 http://msdn.microsoft. 
com/en-us/library/{663144.aspx 上 参阅 在 线 的 官方 Unity 文档 )。 
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7.3 ”本章 小 结 


在 这 一 章 中 ， 我 试 着 用 实体 目 己 的 名 称 和 角色 来 调用 每 一 个 涉及 典型 ASPNET MVC 应 
用 程序 的 实体 。 如 果 乍 一 看 忍 不 住 要 跳 过 这 一 章 ， 被 似乎 没 必 要 的 复杂 性 搞 得 心烦 ， 我 一 点 
儿 也 不 会 觉得 惊讶 ,究竟 为 什么 应 该 创建 一 个 工作 线程 服务 呢 , 它 显然 是 在 浪费 CPU 周期 啊 ? 

如 果 你 的 应 用 程序 比 很 多 已 经 提供 的 指南 应 用 程序 (比如 Music Store) 复 杂 ， 我 认为 是 有 
好 处 的 。 你 应 该 继续 从 操作 方法 调用 实体 框架 数据 上 下 文 ， 并 且 不 用 管 层 和 分 层 架 构 了 。 可 
以 愉悦 舒心 地 以 这 种 方式 设计 很 多 应 用 程序 。 不 应 有 忽视 入 门 级 指南 的 想法 。 它 们 做 了 大 量 
的 工作 让 你 开始 展示 具体 的 内 容 。 

但 是 , 应 该 清楚 那 只 是 第 一 步 。 许多 种 见 做 法 在 模型 和 域 的 复杂 性 方面 的 伸缩 性 并 不 好 。 
在 这 一 章 中 , 我 总 结 了 一 些 把 你 的 ASPNET MVC 应 用 程序 上 升 到 下 一 个 复杂 性 水 平 的 实践 。 
一 个 主要 的 好 做 法 是 通过 将 大 部 分 逻辑 移 除 出 工作 线程 服务 ， 让 控制 器 类 保持 至 精 至 简 。 另 
一 个 好 的 做 法 是 通过 把 代码 移 到 HTML 帮助 器 和 控制 器 , 让 视图 维持 在 尽 可 能 低 的 级 别 和 被 
动 性 ， 最 好 是 通过 强 类 型 的 视图 模型 ， 但 呈现 操作 也 是 可 以 接受 的 。 男 一 个 做 法 是 将 应 用 程 
序 的 后 端 分 层 ， 以 区 分 域 模型 、 域 服务 和 存储 库 。 存 储 库 应 该 是 访问 数据 的 唯一 方式 ， 并 且 
服务 应 该 尽 可 能 地 调用 它们 ， 由 此 将 控制 器 与 它们 分 隔 开 。 

那么 , 简易 指南 是 演示 这 些 内 容 的 错误 方式 吗 ? 不 ， 只 要 你 认为 它们 中 的 代码 是 本 章 (并 
且 在 本 书 的 其 余部 分 中 也 会 作 适 度 介 绍 ) 中 讨论 的 更 一 般 模式 的 一 个 特例 。 

对 于 简单 的 应 用 程序 来 说 ，ASPNET MVC 是 一 个 易 用 的 框架 ; 对 于 复杂 的 应 用 程序 ， 
它 可 能 就 有 些 棘手 了 。 但是, 如 果 掌 握 得 好 ， 生 成 的 代码 肯定 会 是 高 质量 的 比 Web Forms 
中 的 好 得 多 ， 在 技能 和 付出 相同 的 情况 下 。 


8 草 


第 
自 定义 ASP.NET MVC 控制 器 


我 们 需要 那些 追求 梦想 的 人 ， 他 们 梦想 的 事物 从 未 曾 被 梦想 过 ， 


——John F Kennedy 
整个 ASPNET MVC 堆栈 充满 了 扩展 点 。 扩 展 点 是 代码 中 发 生 的 实际 行为 可 以 从 外 部 以 


及 可 葵 换 的 提供 程序 读 取 的 地 方 。 在 前 面 几 章 中， 你 看 到 了 一 些 扩展 点 的 例子 。 例 如 ， 你 看 
到 了 如 何 更 换 控 制 右 工厂 一 一 即 为 每 个 传 入 请 求 返回 新 的 控制 占 类 实例 的 组 件 (参见 第 7 章 
“设计 ASPNET MVC 控制 器 的 注意 事项 ”)。 第 4 章 “ 输 入 表单 ”中 讨论 了 如 何 蔡 换 模 型 元 
数据 的 提供 程序 一 一 即 读 取 要 在 HTML 表单 中 使 用 的 有 关 类 的 元 信息 的 组 件 。 

在 像 ASPNET MVC 这 样 的 编程 框架 中 ， 可 扩展 设计 的 好 处 会 惠及 到 在 其 之 上 构建 的 所 
有 应 用 程序 。 在 这 一 章 中 ， 我 的 目标 是 帮助 你 及 现 可 在 ASPNET MVC 中 找到 的 扩展 点 ， 并 
用 几 个 例子 进行 说 明 。 首 先 我 会 浅 谈 一 下 ASPNET MVC 中 的 扩展 模型 ， 然 后 在 控制 器 方面 
进行 详尽 考察 ， 这 样 你 在 闲暇 时 可 以 进行 自 定义 且 产 生 至 精 至 简 的 控制 器 以 及 提升 可 维护 性 
和 可 读 性 。 


8.1 ASP.NET MVC 的 扩展 模型 


扩展 点 与 扩展 模型 是 紧密 耦合 的 。 这 是 开发 人 员 可 以 去 除 组 件 的 现 有 实现 并 创建 其 自 有 
实现 的 编程 模型 。 在 ASPNET MVC 中 ， 你 有 两 个 在 功能 上 等 效 的 扩展 模型 ， 它 们 要 求 你 使 
用 不 同 的 API。 其 中 一 个 基于 你 使 用 连贯 语法 显 式 注册 的 提供 程序 。 另 一 个 基于 经 典 的 服务 
定位 器 模式 ， 它 的 引入 让 开发 者 从 控制 反 转 (IoC) 框 架 中 受益 无 穷 。 

这 两 个 模型 都 完全 支持 了 内 部 组 件 的 蔡 换 ， 如 视图 引擎 、 操 作 调 用 程序 、 元 数据 提供 者 
和 工厂 。ASPNET MVC 扩展 模型 的 另 一 部 分 基于 特殊 的 特性 一 一 称 为 操作 筛选 器 一 一 用 于 在 
控制 器 方法 的 执行 流 中 插入 自 定 义 (甚至 是 可 选 的 ) 代 码 。 我 们 首先 来 处 理 内 部 组 件 的 替换 。 
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8.1.1 基于 提供 程序 的 模型 


ASPNET MVC 堆栈 的 可 蔡 换 内 部 组 件 是 用 于 非常 特殊 的 情形 的 。 你 不 会 希望 在 你 编写 
的 任何 应 用 程序 中 利用 它们 。 假 设 这 些 扩展 点 只 在 它们 被 需要 的 时 候 存 在 。 如 果 在 某 个 时 候 
你 决定 替换 它们 ， 请 注意 你 是 在 与 ASPNET MVC 的 内 部 机 制 进行 交互 。 因 此 ， 如 果 出 现 性 
能 或 功能 问题 ， 你 的 组 件 会 是 第 一 个 被 质疑 的 对 象 。 
1. 扩展 点 构成 的 库 
表 8-1 提供 了 扩展 点 的 简明 列表 。 


表 8-1 可 蔡 换 组 件 


提供 程 厅 描 述 
操作 调用 程序 DefaultActionInvoker 管理 操作 方法 的 执行 以 及 浏览 器 响应 的 生成 。 它 会 与 筛选 器 
和 视图 引擎 交互 ( 稍 后 会 介绍 关于 它 的 更 多 信息 ) 
控制 右 工 三 DefaultControllerFactory ”| 作为 控制 器 实例 的 工厂 提供 服务 。 它 可 以 用 于 为 新 创建 的 控 
制 器 实例 设置 自 定义 操作 调用 程序 
字典 值 IValueProvider 为 请 求 读 取 要 被 添加 到 输入 值 字典 的 值 。 内 置 值 提供 程序 会 


从 查询 字符 串 、 表 单 、 输 入 文件 以 及 路 由 中 读 取 。 自 定义 提 
供 程序 可 能 会 从 Cookies 或 HTTP 标 头 读 取 


模型 绑 定 句 IModelBinder 定义 将 一 些 值 提供 程序 字典 中 的 原始 值 转换 成 特殊 复 末 类 型 


模型 绑 定 器 提供 | IModelBinderProvider 定义 模型 绑 定 船 工 | ， 它 会 动态 选择 用 于 指定 类 型 的 正确 模 
模型 元 数据 ModelMetadataProvider 检索 与 类 成 员 有 大 的 元 信息 ， 并 将 该 信息 与 类 型 实例 关联 起 

来 。 默 认 提 供 程序 会 从 DataAnnotations 特性 中 读 取 元 信息 
使 型 验证 喜 ModelValidatorProvider 这 一 提供 程序 的 摘 述 与 上 面 的 模型 元 数据 项 相同 ， 只 不 过 它 


的 重点 放 在 了 验证 方面 。 默 认 提 供 程 序 会 从 校 验 
DataAnnotations 特性 中 读 取 元 信息 


TempData ITempDataProvider 作为 被 放置 在 TempData 集合 中 的 数据 存储 提供 服务 。 默 认 
提供 程序 会 使 用 会 话 状态 


饮 图 引 村 IViewEngine 作为 能 够 解释 视图 模板 和 产生 浏览 器 HIML 标记 的 组 件 提 
供 服务 .默认 视图 引擎 能 将 ASPX 和 了 Razor 标 记 转 译 给 HIML 


如 你 所 见 ， 这 些 并 不 是 你 每 天 所 使 用 的 组 件 。 然 而 在 我 多 年 的 编程 生涯 里 ， 对 其 中 的 大 
部 分 至 少 目 定义 过 一 次 ， 但 是 通常 没有 一 次 就 目 定 义 超 过 一 个 或 两 个 的 情况 。 
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2. 一 个 现实 的 场景 : 替换 TempData 存储 


TempData 字典 用 来 存储 从 逻辑 上 讲 属于 当前 请 求 的 数据 , 但 必须 要 路 越 一 个 重 定 回来 使 
用 。 第 4 章 闻 述 了 将 Post-Redirect-Get(PRG) 模 式 上 下 文中 的 TempData 字典 用 于 输入 表单 的 
内 容 。 根 据 PRG 模式 ， 应 该 用 一 个 GET 重 定 问 到 显示 结果 的 视图 来 终止 一 个 POST 请 求 。 
整个 请 求 (比如 ， 验 证 消息 ) 状 态 可 能 会 在 重 定向 过 程 中 丢失 。TempData 字典 提供 了 一 个 用 于 
任何 数据 (主要 是 ModelState) 所 需 的 临时 存储 。 

默认 情况 下 , TempData 字典 会 将 其 内 容 保存 到 会 话 状态 。 直 接 使 用 Session 与 售 助 TempData 
的 主要 区 别 是 ， 任 何人 存储 在 TempData 中 的 数据 都 会 在 连续 请 求 终止 后 目 动 清除 。 换 句 话 说 ， 
数据 驻 留 在 内 存 中 只 会 用 于 两 个 请 求 :当前 请 求 和 下 一 个 重 定 向 。 归 根 结 故 ，TempData 市 给 
内 存 的 压力 更 小 。 

如 有 果 应 用 程序 不 允许 使 用 会 话 状态 呢 ? 

和 要么 你 根据 得 询 字 符 串 给 出 完全 不 同 的 解决 方案 ， 或 者 直接 为 TempData 内 容 提供 不 同 
的 存储 。 那 么 什么 才 是 不 同 的 存储 呢 ? 它 可 以 是 一 个 cookie( 如 果 数 据 的 总 大 小 匹配 对 cookie 
的 大 小 限制 )， 也 可 以 是 一 个 (分 布 式 ) 缓 存 。 如 果 选 择 后 者 ， 那 么 在 每 个 用 户 的 基础 上 存储 数 
据 就 完全 是 你 的 责任 了 。 自 定义 TempData 提供 程序 看 上 去 如 下 所 示 : 

public class CookieTempDataProvider : ITempDataProvider 


{ 
protected override IDictionary<SsString, Object> LoadTempData 
(ControllerContext controllerContext) 


{ ... } 
protected override vold SaveTempData (ControllerContext controllerContext, 
IDictionary<SsString, Object> values) 
{ ... } 
} 
可 以 访问 http://www.stackoverflow.com， 通 过 直接 检查 StackOverflow 问题 找到 一 个 此 
类 的 运行 示例 (以 及 在 表 8-1 中 列 出 的 很 多 其 他 蔡 换 组 件 )。 下 面 是 一 个 我 特别 辟 欢 的 示例 : 
http:/brockallen.com/2012/06/11cookae-based-tempdata-provlder。 


3. 在 应 用 程序 中 使 用 自 定 义 组 件 


很 长 时 间 以 来 ， 注 册 自 定义 组 件 并 没有 标准 方法 。 表 8-1 中 所 列 出 的 每 个 组 件 都 需要 和 目 
己 的 API 来 集成 到 用 户 应 用 程序 。 你 即将 会 看 到 ， 你 现在 有 了 一 个 额外 的 基于 依赖 性 解析 器 
的 模型 ， 它 的 大 部 分 都 类 似 于 ASPNET MVC 早期 版 本 所 支持 的 自 定义 模型 。 

表 8-2 描述 了 如 何 注册 表 8-1 中 所 列 出 的 特殊 的 可 替换 组 件 。 
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表 8-2 注册 可 蔡 换 组 件 


操作 调用 程序 / 在 控制 器 类 的 构造 负数 中 
this.ActionInvoker = new YourActionInvoker(); 
控制 器 工厂 // 在 global.asax 的 Application Start 中 


Var factory = new YourControllerFactory!( ): 
ControllerBuilder.Current.SetControllerFactory(factory): 
// 在 global.asax 的 Application Start 中 


var providerFactory = new YourValueProviderFactory(); 
ValueProviderFactories.Factories.Add(providerFactory); 
模型 绑 定 响 / 在 global.asax 的 Application Start 中 
ModelBinders.Binders.Add(typeof( YourType), new YourTypeBinder()); 
模型 绑 定 器 提供 程序 | // 在 global.asax 的 Application Start 中 
var provider = new YourModelBinderProvider(): 


ModelBinderProviders.BinderProviders.Add(provider): 


模型 元 数据 // 在 global.asax 的 Application Start 中 
ModelMetadataProviders.Current = new YourModelMetadataProvider(); 
模型 校 验 名 /在 global.asax 的 Application Start 中 


var validator = new YourModelValidatorProvider( ): 
ModelValidatorProviders.Providers.Add(validator): 


TempData // 在 控制 副 类 的 构造 函数 中 
this.TempDataProvider = new YourTempDataProvider(); 
饮 图 引擎 // 在 global.asax 的 Application Start 中 


WlewEngimes.Engimnes.Clear(): 
ViewEnemnes.Fnemnes.Add(new YourVlewEnemel )): 


我 想 再 多 谈 一 谈 值 提供 程序 。 就 像 表 8-2 中 所 示 的 代码 片段 一 样 ， 你 管理 的 不 是 一 个 值 
提供 程序 的 集合 ， 而 是 一 个 值 提供 程序 工厂 的 集合 。 这 就 是 说 ， 对 于 每 一 个 你 打算 添加 的 自 
定义 全 提供 程序 ， 你 都 要 编写 两 个 不 同 的 类 : 值 提 供 程序 及 其 工厂 。 但 是 ， 仅 工厂 类 应 当 在 
系统 启动 时 注册 。 值 提供 程序 工厂 是 一 个 精简 封装 ， 如 下 所 示 : 

public class HttpCookieValueProviderFactory : ValueProviderFactory 

{ 

public override IValueProvider GetValueProvider 
(ControllerContext controllerContext) 
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{ 
return new HttpCookieValueProvider (controllerContext); 
} 
} 
这 个 类 表示 一 个 自 定义 值 提供 程序 的 工 ; 在 这 方面 ， 还 有 相当 多 的 由 开发 者 社区 所 提 
供 的 实现 。 可 以 在 StackOverflow 上 找到 一 些 。 
8.1.2 服务 定位 器 模式 
服务 定位 器 是 在 松散 耦合 系统 设计 中 使 用 的 流行 模式 。 该 模式 的 核心 是 一 个 全 局 的 可 访 
问 工厂 类 ， 负 责 为 那些 执行 指定 协议 的 类 实例 提供 服务 。 服 务 定 位 器 与 其 客户 端 之 间 发 生 的 
基本 交互 可 以 概括 为 以 这 样 开 始 的 会 话 : 我 需要 一 个 与 这 个 类 型 作用 一 样 的 对 象 ， 你 是 否 知 
道 一 些 可 以 为 我 实例 化 的 具体 类 型 ? 之 后 服务 定位 器 会 通过 返回 一 个 像 这 样 的 实例 或 null 作 
为 回复 。 
“服务 定位 器 ”( 以 及 像 “ 服 务 定 位 ”这 样 的 表述 ) 这 个 术语 通 音 用 于 表示 某 个 类 获取 外 
部 依赖 性 的 场景 ， 因 此 要 在 扩展 的 时 候 保持 开放 ， 修 改 的 时 候 保持 关闭 。 那 么 服务 定位 堪 ( 或 
位 置 ) 模 陈 与 依赖 注入 之 间 的 真正 区 别 是 什么 呢 ? 


1. 服务 定位 器 与 依赖 注入 对 比 


从 功能 上 讲 ， 服 务 定位 器 (SL) 模 式 与 依赖 注入 (DD 几乎 完全 相同 ， 两 者 都 是 依赖 反 转 原 
则 一 一 流行 的 SOLID 中 的 “D”(SOLID 代表 的 是 单一 职责 、 开 闭 原 则 、 里 氏 蔡 换 、 接 口 隅 离 
以 及 依赖 反 转 原则 ) 的 具体 实现 。SL 历史 上 是 构建 松散 耦合 的 可 测试 系统 所 广泛 采用 的 第 一 
种 模式 。 后 来 DI 作为 完成 同样 任务 的 更 好 一 些 的 方式 被 引入 了 。SL 和 DI 的 区 别 多 少 有 些 
模糊 ， 取 决 于 你 从 何 种 抽象 程度 来 看 待 它们。 当然 ， 在 源 代 码 水 平 还 有 差异 。 使 用 SL， 类 可 
以 通过 查询 外 部 组 件 获取 其 依赖 性 。 使 用 DI, 类 可 以 通过 构造 函数 (或 公共 属性 ) 获 得 依赖 性 。 

下 面 是 使 用 SL 的 类 的 示例 : 

public class FinancelInfoService 


{ 


private IFinder finder; 


private IRenderer renderer; 


public FinancelInfoService() 

{ 
finder = ServiceLocator.GetSservice<IFinder> (}); 
Tenderer = ServiceLocator.GetService<IRenderery> (); 


} 


public String GetQuotesAsHtml]l (String symbols) 
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{ 
Var stocks = finder.FindQuoteInfo (Symbols) ; 
return renderer.RenderQuotelnifo(stocks).; 
} 
} 
使 用 DI 的 相同 类 被 重 构 后 看 起 来 像 这 样 : 
public class FinanceInfoService 
{ 


private IFinder finder; 
private IRenderer renderer; 


public FinanceInfoService (IFinder f, IRenderer r) 
{ 

TTnder = ff; 

renderer = I; 


} 


public string GetQuotesAsHtml] (string symbols) 
{ 
var stocks = finder.FindQuoteInfo (Symbols) ; 
return renderer.RenderQuoteInfol(stocks); 
} 
} 


不 同 之 处 都 在 构造 函数 以 及 如 何 检索 依赖 性 中 。 应 该 使 用 哪 种 方法 呢 ? 

对 于 从 头 开始 构建 的 新 系统 ，DI 是 该 优先 考虑 的 : 它 会 使 代码 保持 得 更 整洁 ， 更 便于 阅 
读 和 测试 。 使 用 DI， 依 赖 性 在 类 的 签名 中 是 显 式 的 。 不 过 ， 周 边框 架 要 对 依赖 性 的 准备 和 注 
入 负 完 全 责任 。 对 于 现 有 系统 ，SL 更 容易 接 入 使 用 ,因为 它 只 会 要 求 你 将 调用 封装 在 一 个 公 
开 接口 的 黑 盒 中 。 


2. ASP.NET MVC 中 的 SL 


ASPNET MVC 设计 有 几 个 扩展 点 ， 但 缺乏 对 DI 的 广泛 支持 。 表 8-2 中 列 出 的 各 种 API 
证 明了 这 一 表述 的 可 信和 度 。 要 让 现 有 框架 通过 添加 新 的 扩展 点 得 以 更 松散 地 耦合 ， 服 务 定 位 
髓 可 能 是 最 有 效 的， 因为 它 是 侵入 性 最 小 的 解决 方案 。 服 务 定 位 器 会 充当 一 个 你 在 特定 的 点 
上 安装 的 黑 盒 ， 并 随后 让 它 找 出 需要 哪些 协议 以 及 如 何 得 到 这 些 协议 。 

与 表 8-2 中 所 列 示 的 API 类 似 ，ASPNET MVC 为 你 提供 了 注册 自己 的 服务 定位 器 的 能 
力 ， 框 架 会 在 任何 需要 解析 依赖 性 的 时 候 使 用 。 服 务 定 位 器 是 可 选 的 ， 使 用 它 或 继续 采用 表 
8-2 中 所 示 的 API 在 功能 上 是 等 效 的 。 

当 解 析 一 个 依赖 性 时 ，ASPNET MVC 通常 会 首先 使 用 内 部 服务 定位 器 。 依 赖 性 能 够 被 
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单独 注册 还 是 多 次 注册 ， 对 实际 行为 的 改变 不 大 。 但 是 从 开发 人 员 的 角 虔 来 看 ， 重 要 的 是 如 
日 定义 组 件 以 两 种 方式 注册 (使 用 服 务 定位 右 或 表 8-2 中 有 所 示 的 任意 APD, 则 优先 考虑 服务 
定位 蓓 。 


注意 : 

单独 注册 的 组 件 对 应 用 程序 来 说 一 定 是 唯一 的 一 个 组 件 。 一 个 例子 就 是 控制 器 工厂 一 一 
你 不 能 在 同一 应 用 程序 中 拥有 两 个 工厂 。 多 次 注册 的 组 件 的 例子 有 视图 引擎 和 模型 验证 提供 
程序 。 在 这 两 种 情况 下 ， 可 以 注册 多 个 实例 并 向 系统 的 其 他 部 分 公开 。 


ASPNET MVC 服务 定位 器 的 实现 是 由 对 称 为 依赖 性 解析 器 的 用 户 定 义 对 象 的 简单 封装 
所 构成 的 。 依 赖 性 解析 器 一 一 对 每 个 应 用 程序 来 说 是 唯一 的 一 一 是 一 个 实现 下 列 接口 的 对 象 : 


public interface IDependencyResolver 


{ 
Object GetSsService (Type serviceType); 
IEnumerable<Object>GetServices (Type serviceType); 
} 


在 解析 器 中 设置 什么 样 的 到 辑 完全 取决 于 你 。 它 可 以 简单 到 一 个 switch 语句 , 检查 类 型 
并 退回 人 固定 类 型 的 实例 。 它 也 可 以 复杂 到 从 配置 文件 中 读 取 信息 和 使 用 反射 来 
创建 实例 。 最 后 ， 它 可 以 基于 Unity 或 其 他 任何 IoC 框架 。 下 面 是 一 个 简单 实用 的 解析 器 : 


public class SampleDependencyResolver : IDependencyResolver 
{ 
public object GetService (Type serviceType) 
{ 
1f (serviceType == typeof (ISomeClass)) 
return new SomeClass ();} 
} 


public IEnumerable<object> GetServices (Type serviceType) 


{ 
return Enumerable.Empty<Object> () ; 


} 
} 


接 下 来 显示 的 代码 是 一 个 使 用 Unity( 及 其 配置 部 分 ) 来 解决 依赖 性 的 解析 器 示例 : 
Public class UnityDependencyResolver : IDependencyResolver 


{ 
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} 


private readonly IUnityContainer container; 


public UnityDependencyResolver() : thls(new UnityContainer () . 
LoadConfiguration () ) 

{ 

} 


public UnityDependencyResolver (IUnityContainer container) 
{ 
container = container; 


} 


public Object GetService (Type serviceType) 
{ 
return container.Resolve (serviceType); 


} 


public IEnumerable<Object> GetServices (Type serviceType) 
{ 
return Container.ResolveAll (serviceType); 


} 


使 用 ASPNETMVC 框架 过 过 DependencyResolver 类 的 SetResolver 方法 注册 目 己 的 解析 


protected vold Application Start () 


{ 


} 


// Prepare and configure the IoC container 
Var container = new UnityContainer (); 


// Create and register the resolver 
Var resolver = new UnityDependencyResolver (container); 
DependencyResolver.SetResolver (resolver}).; 


如 果 在 解析 器 的 内 部 使 用 IoC 框架 ， 就 需要 明白 ， 最 好 的 方式 古 同 其 提供 注册 类 型 的 列 
表 。 如 果 喜 欢 通过 连贯 代码 传递 该 信息 ， 则 需要 在 创建 解析 器 之 前 完全 配置 IoC 容 需 对 象 。 
如 果 打 算 通 过 使 用 web.config 文件 配置 IoC， 则 可 以 使 用 解析 器 的 默认 构造 函数 一 一 就 Unity 
而 言 一 一 它 包 含 一 个 加 载 配 置 数 据 的 调用 。 不 过 请 注意， 如果 针 对 的 是 一 个 不 同 的 IoC 框 染 ， 
则 可 能 需要 更 改 此 代码 。 
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重要 提示: 

依赖 性 解析 器 是 一 个 内 部 工具 ， 开 发 人 员 可 以 选择 性 地 使 用 来 创建 自己 的 自 定义 组 件 而 
不 是 系统 组 件 。 依赖 性 解析 器 的 功能 仅 限于 ASPNET MVC 所 支持 的 方式 使 用 。 换 名 话说 ， 
例如 ， 如 果 ASPNET MVC 不 在 创建 控制 器 缓存 之 前 调用 解析 器 ， 你 想 靠 自己 去 替换 内 置 缓 
存 就 非 季 难 了 。 


8.2 在 控制 希 中 状 加 特性 


在 ASPNET MVC 中 你 会 发 现 一 种 完全 不 同 的 基于 可 以 附加 到 控制 器 类 和 方法 上 的 特性 
的 自 定 义 形 式 。 这 些 特性 通常 称 为 操作 筛选 器 。 操 作 筛选 器 是 一 段 围 绕 操作 方法 的 执行 而 运 
行 的 代码 ， 并 可 用 于 修改 和 扩展 在 方法 本 身 中 便 编 码 的 行为 。 
8.2.1 操作 筛选 器 

操作 筛选 占 可 完全 由 下 面 的 接口 表示 : 

public interface IActionFilter 

{ 

Vold OnActionExecuting (ActionExecutingContext filterContext),; 


Vold OnActionExecuted (ActionExecutedContext filterContext).; 


} 


可 以 看 到 ， 它 为 你 提供 了 一 个 可 以 在 操作 执行 之 前 和 之 后 运行 代码 的 挂钩 。 从 筛选 毁 内 
部 ， 可 以 访问 请 求 和 控制 右上 下 文 ， 还 可 以 读 取 和 修改 参数 。 


1. 能 入 式 和 外 部 筛选 器 


用 户 定 义 的 每 个 控制 器 都 是 从 Controller 类 继承 而 来 的 。 这 个 类 作为 可 重 写 的 受 保护 成 
员 实 现 了 IActionFilter 并 公开 了 OnActionExecuting 和 OnActionExecuted 方法 。 这 意味 着 每 
个 控制 器 类 都 让 你 有 机 会 决定 之 前 做 什么 、 之 后 做 什么 、 或 者 在 调用 指定 方法 之 前 和 之 后 做 
什么 。 让 我 们 看 一 些 在 调用 Index 方法 时 会 添加 特 设 响应 标 头 的 代码 。 


protected DateTime StartTime; 
protected override void OnActionExecuting (ActionExecutingContext 
filterCcontext) 
{ 
Var action = filterContext.ActionDescriptor.ActionName; 
1f (String.Equals (action, "index", 
stringComparison.CurrentcultureIgnoreCase)) 


{ 
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StartTime = DateTime .Now: 


base.OnActionExecuting (filterContext); 


} 

protected override vold OnActionExecuted (ActionExecutedContext filterContext) 
{ 

var action = filterContext.ActionDescriptor.ActionName; 

1f (String.Egquals (action, "index", StringComparison. CurrentCultureIdnorecase) ) 
{ 


Var 七 ImeSpan = DateTime.Now - StartTime; 
f11terContext .ReduestContext .HttpContext .Response .AddHeader ( 
"despos-mvc4", timeSsSpan.Milliseconds.Tostring ()); 


} 


base.onActionExecuted (filtercontext). 
} 
图 8-1 显示 了 该 方法 计算 其 执行 的 量 秒 数 ， 并 将 该 数值 写 入 新 的 啊 应 标 头 。 


四 吉本 Hon ne = Fi7 


HTML CSS Console Script Profiler | i Search Coptured Tra, 


RR 器 回 | Stopcaptuing | | Backtosummayview | | <prev | 


URL: http: /Mocalhost:51846/ 


Requestheaders | Request body | Response headers |Response body | Cooks “| 


Value 


HTTP/L 1 200 OK 

ASP,NET Development Server/10,0,.0.0 
sat, 30 Mar 2013 13: 和 :38 GMT 
4.0.30319 

40 


Brivate 

text/html: charset=utf-8 
ContentLength 1058 
Connmection Close 


图 8-1 添加 到 Index 方法 的 自 定 义 响应 标 头 


如 果 在 一 个 控制 器 类 中 重 写 这 些 方法 ， 最 后 所 有 的 控制 器 方法 都 会 有 一 个 before/after 代 
码 的 单独 存储 库 。 只 要 你 想 要 为 每 个 方法 执行 相同 的 操作 ， 这 种 方式 都 管用 。 如 有 果 要 在 每 个 
方法 的 基础 上 区 分 操作 ， 把 操作 筛选 右 用 作 特 性 可 能 是 一 个 值得 答 试 的 技巧 。 

操作 季 选 器 作为 一 个 特性 被 实现 ， 它 提供 了 将 某 些 行为 附加 到 控制 器 操作 方法 上 的 声明 


司 
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式 途径 。 通 过 编写 操作 筛选 器 ， 可 以 挂 接 操作 方法 的 执行 管道 ， 并 使 它 适应 于 你 的 需要 。 朋 
这 种 方式 ， 还 可 将 并 不 严格 属于 控制 器 的 逻辑 从 控制 器 类 中 去 除 。 这 样 的 话 ， 这 种 特殊 行为 
便 具 有 了 可 重用 性 ， 更 重要 的 是 ， 具 备 了 可 选 性 。 操 作 筛选 器 对 于 实现 影响 你 控制 器 生存 其 
的 横 切 关注 点 的 解决 方案 来 说 是 不 错 的 。 


2. 操作 筛选 器 的 分 类 


操作 科 选 器 根据 其 实际 完成 的 任务 分 成 不 同 的 类 型 。 操 作 季 选 器 的 特点 是 具有 一 个 接 
口 ; 每 种 类 型 的 科 选 器 具有 一 个 不 同 的 接口 。 特 殊 的 操作 蹄 选 器 包括 异常 科 选 器 、 授 权 筛 选 
器 和 结果 算 选 器 。 表 8-3 列 出 了 ASPNET MVC 中 的 操作 算 选 器 类 型 。 


表 8-3 ASP.NET MVC 中 操作 筛选 器 的 类 型 


筛选 器 接口 描 述 
IActionFilter 定义 两 个 方法 ， 一 个 在 控制 器 操作 之 前 执行 ， 另 一 个 在 其 之 后 执行 


LAuthenticationFilter 定义 在 操作 管道 中 早期 执行 的 方法 ， 让 你 可 以 自 定 义 身 份 验证 处 理 过 程 并 且 还 将 不 
同 的 身份 验证 策略 用 于 不 同 的 操作 方法 和 控制 苍 上 
LAuthorizationFilter 定义 在 届 份 验证 之 后 执行 的 方法 ， 让 你 可 以 验证 用 户 是 耕 有 权 执 行 操 作 


IExceptionFilter 定义 在 控制 器 操作 执行 期 间 抛 出 异常 时 运行 的 方法 
IResultFilter 定义 两 个 方法 ， 一 个 在 操作 络 采 处 理 过 程 之 前 执行 ， 画 一 个 在 其 之 后 执行 


表 8-3 中 所 有 接口 的 实现 会 产生 在 Controller 类 上 的 几 个 附加 方法 。 表 8-4 列 示 了 这 些 方 
法 以 及 对 其 的 注释 。 
表 8-4 控制 闫 类 中 的 科 选 方 法 


万 法 朱 ” 述 
OnActionExecuting 在 执行 操作 方法 前 调用 
OnActionExecuted 在 操作 方法 执行 完成 后 调用 
OnAuthentication 当 操 作 方 法 的 身份 验证 友 生 时 调用 
OnAuthorization 当 授 权 操 作 方 法 的 身份 验证 时 调用 
OnException 当 操 作 方 法 中 友 生 和 卉 和 汕 时 调用 
OnResultExecuting 在 操作 结果 被 执行 前 调用 
OnResultExecuted 在 操作 结果 执行 完成 后 调用 


所 有 这 些 方法 都 是 虚拟 的 且 受 保护 的 ， 可 以 在 你 的 控制 器 类 中 重 写 它们 以 实现 更 具体 的 
行为 。 
让 我 们 进一步 研究 一 些 预 定义 的 操作 沛 选 器 。 
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3. 内 置 的 操作 筛选 器 


ASPNET MVC 附带 了 一 些 预 定义 的 筛选 问 ， 其 中 的 一 些 在 前 面 几 章 中 讨论 过 了 : 
HandleError、Authorize 和 OutputCache 束 是 其 中 的 一 部 分 。 表 8-5 列 出 了 ASPNET MVC 中 


可 用 的 内 症 贤 选 苍 。 

表 8-5 ASP.NET MVC 中 预定 义 的 筛选 器 
AsyncTimeout 将 一 个 操作 方法 标记 为 将 异步 执行 并 在 指定 毫秒 值 内 终结 的 方法 。 异 步 方法 还 具 

有 一 个 伴随 特性 用 于 设置 不 超时 。 该 伴随 特性 是 NoAsyncTimeout 

Authorize 将 一 个 操作 方法 标记 为 仅 能 由 指定 用 户 、 角 色 或 两 者 一 起 访问 的 方法 
ChildActionOnly 将 一 个 操作 方法 标记 为 仅 能 作为 子 操作 在 呈现 操作 运行 期 间 执 行 的 方法 
HandleFrror 将 一 个 操作 方法 标记 为 十 要 对 该 方法 执行 期 间 抛 出 的 寞 弟 目 动 处 理 的 方法 
OutputCache 将 一 个 操作 方法 标记 为 需要 缓存 其 输出 的 方法 
RequireHttps 将 一 个 操作 方法 标记 为 需要 安全 请 求 的 方法 。 如 果 该 方法 通过 HTTP 调用 ， 则 特 


性 会 强制 通过 HITPS 连接 昔 定 问 到 相同 的 URL， 如 末 可 能 的 话 
ValidateAntiForgeryToken | 将 一 个 操作 方法 标记 为 需要 针对 每 个 POST 请 求 页 面 中 防伪 令 牌 进行 验证 的 方法 
ValidateInput 将 一 个 操作 方法 标记 为 其 提交 的 输入 数据 可 能 (或 可 能 不 ) 十 要 验证 的 方法 


每 个 控制 器 方法 可 以 用 多 个 贤 选 器 来 修饰 。 因 此 处 理 往 选 器 的 顺序 就 很 重要 了 。 表 8-5 
中 所 列 的 所 有 特性 均 从 基 类 FilterAttribute 派生 而 来 ， 它 定义 了 一 个 基本 属性 Order。Order 
属性 表明 了 多 个 特性 的 应 用 顺序 。 默 认 情 况 下 ，Order 属性 会 被 分 配 一 个 -1 值 ， 表 示 未 指定 
顺序 。 但 是 ， 任 何 未 指定 顺序 的 筛选 器 始终 会 在 具有 固定 顺序 的 峰 选 器 之 前 执行 。 最 后 ， 注 
意 如 果 对 一 个 方法 上 的 两 个 或 多 个 操作 科 选 器 显 式 设置 相同 的 顺序 ， 将 引发 寞 季 。 

4. 全 局 筛选 器 

可 以 把 沛 选 器 应 用 于 单个 方法 ， 也 可 以 应 用 于 整个 控制 器 类 。 如 果 将 贤 选 器 应 用 于 控制 
器 类 ， 则 会 对 所 有 由 控制 堪 公 开 的 操作 方法 产生 影响 。 与 此 相反 的 是 ， 全 局 过 滤器 是 在 应 用 
程序 局 动 时 注册 并 目 动 应 用 于 任何 控制 占 类 的 任何 操作 。 

有 认 情 ; 况 下 ，HandleError 饥 选 器 是 在 global.asax 中 全 局 注册 的 ， 这 意味 看 它 对 所有 操作 
方法 提供 了 一 些 异 党 处 理 功能 。 全 局 筛选 句 束 是 以 另外 一 种 方式 注册 的 普通 操作 筛选 器 ， 如 
下 所 示 : 


GlobalFilters.Filters.Add (new HandleError()):; 


GlobalFilters 集合 在 各 个 操作 被 调用 之 前 会 由 当前 的 操作 调用 程序 对 其 进行 检查 ， 并 且 


266 


第 8 章 自 定义 ASPNET MVC 控制 器 


找到 的 所 有 算 选 器 都 会 被 添加 到 已 局 用 的 租 选 器 列表 中 ， 以 对 操作 进行 预 处 理 和 后 处 理 。 我 
还 会 在 本 章 稍 后 继续 谈 及 操作 调用 磺 和 用 于 每 个 操作 的 筛选 器 列表 。 


8.2.2 ”操作 沛 选 器 库 


总 体 来 看 ， 操 作 和 沛 选 器 在 ASPNET MVC 内 部 形成 了 一 个 租 入 式 的 面向 方面 的 框架 。 
ASPNET MVC 提供 了 许多 预定 义 的 科 选 器 ， 但 也 可 以 自己 编写 。 编 写 操 作 季 选 器 的 时 候 ， 
你 通常 要 继承 FilterAttribute， 然 后 实现 一 个 或 多 个 在 表 8-3 中 所 定义 的 接口 。 不 过 ， 大 部 分 
的 时 间 ， 可 以 采用 较 短 的 路 径 一 一 派生 自 ActionFilterAttribute。ActionFilterAttribute 类 是 用 于 
创建 自 定 义 操 作 筛 选 器 的 另 一 个 更 丰富 的 基 类 。 它 继承 自 FilterAttribute， 并 且 提 供 了 一 个 用 
于 表 8-3 中 列 出 的 所 有 接口 的 默认 实现 。 让 我 们 看 几 个 操作 筛选 器 示例 是 怎么 编写 的 。 


注意 : 

操作 筛选 器 是 封装 特定 行为 的 自 定义 组 件 。 当 你 想 隔离 这 种 行为 并 希望 轻易 复制 它 时 ， 
就 可 以 编写 一 个 操作 筛选 器 。 行 为 的 可 重用 性 是 决定 是 否 要 编写 操作 筛选 器 的 因素 之 一 ， 但 
不 是 唯一 的 因 了 条 。 操 作 筛 选 器 也 起 到 保持 控制 器 代码 至 精 至 简 的 作用 。 一 般 而 言 ， 每 当 你 的 
ecient he og Apes evn feme el 
代码 ) 可 以 移 到 操作 筛选 器 。 这 会 在 很 大 程度 上 提高 代码 的 可 读 性 。 


1. 添加 响应 标 头 

拥有 一 个 目 定 义 操 作 筛 选 器 的 经 典 方 案 是 将 你 希望 应 用 于 许多 (但 不 一 定 是 全 部 ) 操 作 方 
法 的 重复 行为 封装 起 来 。 一 个 典型 的 例子 是 在 方法 的 啊 应 中 添加 一 个 自 定义 标 涉 。 在 本 章 的 
前 面部 分 ， 你 看 到 了 如 何 通 过 在 控制 器 类 中 使 用 IActionFilter 本 地 实现 来 达成 这 一 点 。 下 面 
的 代码 显示 了 如 何 将 代码 移出 控制 器 使 其 变 成 一 个 单独 的 类 : 


public class AddHeaderAttribute : ActionFilterAttribute 


{ 
public String Name { get; set; } 
public String Value { get; set; } 
public override vold OnActionExecuted (ActionExecutedContext 
filterContext) 
{ 
1f (!Strlng-IsSNULLOFrEmpty (Name) && !String.IsNullorEmpty (Value) ) 
fl11terContext .RedqduestContext .HttpContext .Response.AddHeader 
(Name，ValuUel) : 
return; 
} 
} 
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现在 你 有 了 一 段 易 于 管理 的 代码 。 可 以 将 其 附加 到 任意 数量 的 控制 器 操作 、 一 个 控制 器 
的 所 有 操作 ， 其 至于 全 局 到 所 有 控制 占 。 所 有 这 些 只 需要 添加 一 个 特性 ， 如 下 所 示 : 
[AddHeader (Name="Action", Value="About")] 


public ActionResult About () 
bE 


你 可 能 认为 此 示例 并 不 完全 等 同 于 之 前 的 那个 ， 在 其 中 我 们 计算 出 了 操作 的 起 始 时 间 和 
完成 时 间 之 间 的 间隔 。 事 实 上 ，AddHeader 筛选 器 只 是 添加 了 一 个 固定 标 头 。 可 以 派生 一 个 
新 类 一 一 比如 ReportDuration 并 在 其 中 应 用 你 需要 的 所 有 远 香 : 

public class ReportDurationAttribute : AddHeaderAttribute 


{ 
protected DateTime StartTime; 


public override void OnActionExecuting (ActionExecutingContext filterContext) 
{ 

StartTlme = DateTlme .Now; 

base.OnActionExecuting (filterContext).; 
} 


public override vold OnActionExecuted (ActionExecutedContext filterContext) 


{ 
Var 七 ImeSpan = DateTime.Now - StartTime; 
Value = timesSpan.Milliseconds.Tostring (); 
base.onActionExecuted (filterContext) 

} 


} 


我 们 看 一 个 稍 复杂 点 儿 的 例子 。 在 这 个 例子 中 ， 我 们 将 压缩 方法 啊 应 ， 这 是 一 个 有 用 的 
功能 ， 尤 其 是 当 返 回 大 的 HIML 或 二 进 制 数据 块 的 时 候 。 


2. 压缩 啊 应 


近来 ，HTTP 压缩 成 为 了 一 种 几乎 每 个 网 站 都 承受 得 起 的 功能 ， 因 为 在 这 方面 有 问题 的 
浏览 器 数目 几 近 于 零 ( 在 过 去 10 年 间 发 布 的 任何 浏览 器 都 能 够 识别 这 个 最 流行 的 压缩 方案 )。 

在 ASPNET Web Forms 中 ， 压 缩 一 般 是 通过 HTTP 模块 拦截 请 求 和 压缩 响应 来 实现 的 。 
你 还 可 以 在 互联 网 信息 服务 (IIS) 级 别 开 启 压缩 。 这 两 个 选项 在 ASPNET MVC 中 都 好 用 ， 决 
定 使 用 哪 一 个 选项 取 诀 于 你 。 你 通 各 需要 根据 所 要 控制 的 参数 来 做 决定 ， 包 括 要 压缩 资源 的 
MIME 类 型 、 压 缩 级 别 、 要 压缩 的 文件 等 。 

ASPNET MVC 提供 了 特别 容易 实现 的 第 三 个 选项 : 一 个 对 压缩 事项 进行 设置 的 特定 操 
作 筛 选 器 。 用 这 种 方式 ， 可 以 在 不 必 编 写 HTTP 模块 的 情况 下 控制 某 种 特定 的 URL。 我 们 来 
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看 另 一 个 在 用 于 特定 方法 的 啊 应 流 中 添加 压缩 的 操作 筛选 器 示例 吧 。 

一 般 情况 下 ，HTTP 压缩 由 两 个 参数 控制 : 浏览 器 随 每 个 请 求 发 送 的 Accept-Encoding 标 
头 和 Web 服务 器 随 每 个 啊 应 发 送 的 Content-Encoding 标 头 。Accept-Encoding 标 头 指明 浏览 
器 只 能 处 理 指定 的 编码 一 一 通常 情况 下 是 gzip 和 deflate"。Content-Encoding 标 头 会 指明 响应 
的 压缩 格式 。 请 注意 Accept-Encoding 标 头 只 是 . -个 由 浏览 左上 友 送 的 请 求 标 头 ; 服务 占 并 没有 
必要 返回 压缩 的 内 容 。 

谈 到 编写 压缩 过 滤器 ， 最 难 的 部 分 在 于 获得 对 浏览 器 所 请 求 内 容 的 充分 理解 。 下 面 是 一 
些 有 用 的 代码 : 

public class CompressAttribute : ActionFilterAttribute 

public override vold OnActionExecuting (ActionExecutingContext 

filtercontext) 


// Analyze the 11st of acceptable encodings 
Var preferredEncoding = GetPreferredEncoding (filterContext. 
HttpcCcontext .Request)}); 


// Compress the response accordingly 

Var response = filterContext.HttpContext .Response; 

response.AppendHeader ("Content-encoding", 
preferredEncoding.Tostring ()); 


1f (preferredEncoding == Compressionscheme .Gz1p) 
response.Filter = new GZipStream(response.Filter, 
CompresslionMode.Compress); 
1f (preferredEncoding == Compressionscheme.Deflate) 
response.Filter = new Deflatestream(response.Filter, 
CompresslonMode.Compress); 


return; 


private Compressionscheme GetPreferredEncoding (HttpRequestBase request) 


CO gzip 最 早 由 Jean-Loup Gailly 和 Mark Adler 创建 ， 用 于 UNIX 系统 的 文件 压缩 。 我 们 在 Linux 中 经 常 
会 用 到 后 级 为 .gz 的 文件 , 它们 就 是 gzip 格式 的 。 现今 已 经 成 为 互联 网 上 使 用 非常 普遍 的 一 种 数据 压缩 格式 ， 
或 者 说 一 种 文件 格式 。HITP 协议 上 的 gzip 编码 是 一 种 用 来 改进 Web 应 用 程序 性 能 的 技术 。 大 流量 的 Web 
站 点 常常 使 用 gzip 压缩 技术 来 让 用 户 感 受 更 快 的 速度 。 

deflate 是 同时 使 用 了 LZ77 算法 与 喻 夫 曼 编码 (Huffiman Coding) 的 一 个 无 损 数 据 压缩 算法 。 它 最 初 是 由 
Phil Katz 为 他 的 PKZIP 归档 工具 第 二 版 所 定义 的 ， 后 来 定义 在 RFC 1951 规范 中 。 
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Var acceptableEncoding = fedquest.Headers ["Accept-Encoding"] .ToLower (); 
1f (acceptableEncoding.Contains ("gzip")) 

return Compresslonscheme .Gz1ip; 
if (acceptableEncoding.Contains ("deflate")) 


return Compressionscheme.Deflate,; 


return Compressilonscheme.Identity; 


enum Compressionscheme 


{ 
Gzlp = 0， 
Deflate = 1, 
Identity = 2 
} 


} 
将 Compress 特性 应 用 于 如 下 所 示 的 方法 : 


[Compressl 
public ActionResult Index() 
和 


8-2 显示 出 Content-Encoding 啊 应 标 头 设置 正确 ， 而 啊 应 被 理解 并 在 浏览 右 中 解压 缩 。 


> About us - FI2 | 


File Find Disable View lImages Cache Tools Validate 


Brovwser Mede JEO Decument hede Standards 国 | 


HTML C55 Console Script Profiler| Network | |Search Coptured Troffic 


i 
URL: http: Mocalhoat: 5184 /Home/Abaut 
| Request headers | Remuest body | Response headers Response bady | Coolies | Initiater | Timings| 
Yalue 
HTTP/L 1 WO0 OK 
ASP.NET Development Server /10.0.0.0 
Sat, 30 Mar 2013 15:22:48 GMT 
a4.0.30319 


图 8-2 ”底层 HTTP 流量 的 检视 显示 了 用 到 的 带 有 编码 描述 的 自 定义 标 尖 
几乎 所 有 浏览 器 都 将 Accept-Encoding 标 头 设置 为 字符 串 “gzip,deflate”， 但 这 并 不 是 唯 
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一 可 行 的 。 可 以 在 RFC 2616 (参见 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html) 中 
看 到 ，Accept 标 头 字段 支持 将 q 参数 作为 对 可 接受 值 分 配 优 先 权 的 一 种 方式 。 下 面 的 字符 串 
对 于 编码 是 可 接受 的 值 : 

gzip, deflate 

gzip;qd=.7,deflate 

gzip;9=.5, deflate;q=.5,1identity 

即使 gzip 出 现在 所 有 的 字符 串 中 ,但 也 只 有 出 现在 第 一 个 字符 串 中 它 才 是 首选 。 如 果 未 
指定 值 ，q 参数 即 设置 为 1; 这 是 将 deflate 分 配 到 第 二 个 字符 串 中 ， 并 为 第 三 个 字符 串 中 的 
身份 分 配 一 个 比 gzip 高 的 级 别 。 所 以 , 只 检查 gzip 是 否 出 现在 编码 字符 串 中 仍然 会 回 发 一 些 
浏览 器 可 接受 的 内 容 ， 但 并 不 会 充分 考虑 浏览 器 的 仿 好 。 要 编写 一 个 将 通过 q 参数 所 表示 的 
优先 权 ( 如 果 有 的 话 ) 纳 入 考虑 的 Compress 特性 ， 你 需要 完善 GetPreferredEncoding 方法 ， 如 
FA 


private CompresslonScheme GetPreferredEncoding (HttpRequestBase request) 


{ 
Var acceptableEncoding = request.Headers["Accept-Encoding"] .ToLower (); 
acceptableEncoding = SortEncodings (acceptableEncoding); 


1if (acceptableEncoding.Contains ("gzip")) 
return CompresslonScheme .GzZ1ip; 

1f (acceptableEncoding.Contains ("deflate"™)) 
return CompressionSscheme.Deflate; 


return CompressionSscheme.Identity; 


} 

SortEncodings 方法 会 解析 标 头 字符 串 并 提取 对 应 于 最 高 优先 权 选 择 的 那 一 段 。 

3. 视图 选择 器 

第 5 章 “ASPNET MVC 应 用 程序 特性 ”中 讨论 了 CultureAttribute 筛选 器 ， 用 来 将 特定 
的 区 域 强 制 用 于 指定 的 操作 方法 ， 从 而 获得 为 请 求情 用 本 地 化 的 效果 。CultureAttribute 往 选 
器 如 果 是 作为 全 局 筛选 器 安装 的 ， 就 会 正常 运行 。 我 不 会 再 讨论 操作 筛选 器 实现 本 地 化 的 用 
途 了 。 然 而 ， 接 下 来 要 说 的 筛选 器 ， 仍 然 属于 这 个 筛选 器 类 ， 可 以 为 指定 的 操作 选择 不 同 的 
视图 。 假 设 你 要 根据 请 求 浏览 器 的 功能 切换 到 一 个 不 同 的 视图 模板 。 


注意 : 
虽然 从 了 解 操作 入 选 器 在 ASPNETMVC 中 使 用 范围 的 角度 来 说 , 下 面 的 示例 仍然 有 用 ， 
但 示例 揭示 的 特定 功能 可 以 通过 使 用 一 种 名 为 显示 模式 的 新 功能 在 最 新 的 ASPNET MVC 中 
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以 更 有 效 和 更 紧凑 的 方式 得 以 实现 。 我 将 在 第 13 章 “ 构 建 用 于 多 种 设备 的 网 站 ”中 详细 讨论 
显示 模式 。 


创建 一 个 多 任务 的 应 用 程序 不 容易 ， 但 更 重要 的 是 ， 它 往往 是 一 个 特定 于 项 目的 解决 方 
接 下 来 我 将 说 明 篇 选 占 在 帮助 你 筹划 多 任务 解决 方案 中 可 以 友 挥 的 作用 。 说 得 更 清楚 一 
0 0 de 不 同 而 以 不 同 的 方式 服务 相同 请 求 的 一 种 应 用 


直到 几 年 前 ， 一 个 经 典 的 多 任务 示例 就 是 使 用 用 于 富 浏览 的 页 面 和 用 于 欠缺 丰富 性 的 
果 面 浏 贤 器 的 页面 。 今天 ，Ajax 和 JavaScript 库 已 经 明显 弱化 了 这 一 问题 的 影响， 因为 
JavaScript 库 ( 比 如 jQuery) 现 在 可 以 对 开 友 人 员 隐 藏 大 部 分 的 兰 异 。 然 而 ， 新 兴 的 分 化 在 于 果 
面 浏览 右 和 移动 设备 浏览 右 之 间 。 这 两 个 类 别 的 界限 不 像 看 起 来 那样 清晰 。 归 根 结 抑 ， 界 限 
定义 取决 于 你 。 定 义 界 限 意味 着 你 要 决定 如 何 处 理智 能 手机 和 平板 电脑 ， 并 决定 使 用 功能 较 
弱 的 葡 入 到 移动 设备 和 移动 电话 的 浏览 器 要 完成 什么 任务 。 人 然而， 出 于 本 章 目 标的 考虑 ， 我 
会 假设 你 知道 这 两 者 之 间 的 界限 在 哪里 。 所 以 ， 我 会 继续 进行 对 知道 如 何 根 据 用 户 代 理 字 符 
串 和 你 的 规则 切换 视图 的 操作 筛选 器 的 讨论 。 

方法 其 实 就 是 编写 一 个 在 操作 执行 以 后 介入 且 在 操作 调用 程序 开始 之 前 处 理 结果 的 得 
选 占 。 根 据 表 8-3 中 所 示 的 分 类 ， 这 从 拉 术 上 讲 是 结果 沛 选 右 。 让 我 们 看 看 下 面 示例 中 的 源 

Public class BrowserspecificAttribute : ActionFilterAttribute 

public override vold OnResultExecuting (ResultExecutingContext filterContext) 

{ 


} 


该 贤 选 器 继承 自 ActionFilterAttribute 并 重 写 了 OnResultExecuting 方法 。 该 方法 在 执行 操 
作 方 法 以 后 被 调 用 ， 但 会 在 操作 结果 被 处 理 之 前 生成 用 于 浏览 器 的 啊 应 。 


Public override vold OnResultExecuting (ResultExecutingContext filterContext) 
{ 
Var viewResult = filterContext.Result as ViewResult; 
1f (viewResult == null) 
return; 


// Figure out the view name 

Var context = filterContext.Controller.ControllerContext; 
Var viewName = viewResult.VijewName; 

1f (String.IsNullorEmpty (viewName)) 
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viewName = Context .RouteData .GetRedulredStrlInd("act1lon") ; 
1f (String.IsNullorEmpty (viewName)) 
return; 


// Resolve the view selector 
Var viewSelector = DependencyResolver.Current.GetService (typeof 
(IViewSelector)) as IViewSelector; 
1f (viewSelector == null) 
viewSelector = new DefaultViewSelector(); 


// Figure out the browser name 

Var 1sSMobileDevice = context.HttpContext.Request .Browser.IsMoblleDevice; 

Var browserName = (ilisMobileDevice ?2"mobile™" :context.HttpContext. 
Request .Browser.Browser); 


// Get the name of the browser-specific view to use 
Var newVliewName = viewSelector.GetViewName (viewName, browserName); 
1if (String.IsNullOorEmpty (newViewName)) 

returns 


// Is there such a view? 


Var result = System.Web.Mvc.ViewEngines.Engines.FindView (context, 
newVlilewName, viewResult.MasterName); 
1f (result.View != null) 


ViewResult .ViewName = newVliewName: 


} 


采用 的 算法 很 简单 。 使 用 ControllerContext 对 象 ， 该 科 选 器 会 从 请 求 上 下 文 检索 Request 
对 象 ， 从 那里 可 以 查 明 当前 浏览 器 的 功能 。 浏 览 器 的 名 称 会 被 用 作 决 定 要 选择 的 下 一 个 视图 
的 黎 列 项 。 

IViewSelector 类 型 的 对 象 会 解析 指定 浏览 器 名 称 的 视图 名 称 。 下 面 显示 了 一 个 默认 的 视 
图 选择 器 的 实现 : 

public class DefaultViewSelector : IViewSelector 

{ 

public String GetViewName (String viewName, String browserName) 


{ 


return string.Format (™{0} {1}", vliewName, browserName); 


public String GetMasterName (String masterName, String browserName) 
{ 


return string.Format ("{0} {1}", masterName, browserName); 
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} 
} 


该 代码 假定 ， 指 定 一 个 视图 名 称 为 hdex， 对 于 互联 网 浏览 器 (IE) 一 一 该 视图 的 特定 版 本 
名 为 Index 正 ， 而 Firefox 的 版 本 名 为 Index Firefox， 依 此 类 推 。 在 和 选 器 确定 了 要 显示 的 候 
选 视图 的 名 称 以 后 , 它 还 会 检查 当前 的 视图 引擎 , 看 看 是 任 文 持 该 视图 。 如 果 文 持 , ViewResult 
要 呈现 的 ViewName 属性 就 会 被 设置 成 特定 于 浏览 器 的 视图 。 如 果 没 有 友 现 特定 于 浏览 器 的 
视图 ， 你 也 不 需要 做 什么 ， 因 为 由 操作 方法 调用 的 通用 视图 仍然 会 起 作用 ， 如 图 8-3 中 所 示 。 

丫 Multi-serving x 


€ 让 CG 省 | 日 Ilocalhost51846/home/multi 
问 虹 


Fun with filters 


This is a specific view optimized 
for Chrome. 


8-3 ”为 Chrome 优化 的 视图 


如 果 请 求 浏览 器 刚好 是 移动 设备 的 浏览 需 ， 则 会 选择 名 为 xxx_mobile 的 视图 。 
使 用 该 特性 再 简单 不 过 了 。 你 所 需要 做 的 只 是 用 该 特性 来 修饰 控制 右 方 法 ， 如 下 所 示 : 


[BrowserSpec1lflc] 
Public virtual ActionResult Index () 


{ ... } 


这 样 一 个 操作 往 选 器 使 你 不 必 同 每 个 控制 器 方法 添加 一 堆 站 语句 ， 以 便 为 每 个 受 支 持 的 
浏览 器 返回 一 个 不 同 的 ViewResult 对 象 : 
Public virtual ActionResult Index() 
{ 
1f (GetCurrentBrowser() == "™IE"™) 
return View("Index IE"); 
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你 可 能 仍然 认为 这 段 代 码 在 东 些 边缘 情况 下 是 需要 的 ， 但 操作 筷 选 右 可 以 让 你 得 以 将 其 
从 控制 占 类 分 离 出 来 ， 从 而 简化 整个 设计 。 


注意 : 

从 这 个 例子 中 ， 可 以 清楚 地 看 到 为 什么 ASPNETMVC 有 别 于 Web Forms 以 及 它们 之 间 
相册 的 程度 。 切 换 视 图 在 Web Forms 中 也 绝对 可 能 实现 ， 但 它 需 要 一 点 非 第 规 处 理 一 一 切换 
母 版 页 ， 以 编程 方式 加 载 用 尸 控件 和 以 编程 方式 更 改 模板 。 这 是 在 设计 Web Forms 时 不 会 优 
先 考 虑 的 编程 方面 的 内 容 ， 因 为 它 涉及 的 问题 不 太 敏 感 。 现 在 不 一 样 了 ，ASPNET MVC 使 
它 更 故 于 处 理 与 开发 人 员 有 关 的 问题 。 

8.2.3 ”特殊 筛选 器 

到 目前 为 止 ， 操 作 筑 选 器 被 认为 是 旨 在 拦截 操作 方法 执行 的 几 个 阶段 的 组 件 。 如 果 想 添 
加 一 些 代码 来 帮助 决定 某 指定 方法 是 否 适 于 服务 某 指定 操作 呢 ? 对 于 这 种 自 定义 类 型 ， 就 需 
要 另 一 个 类 别 的 和 划 选 器 了 : 操作 选择 右 。 

操作 选择 器 有 两 种 类 别 : 操作 名 称 选 择 左 和 操作 方法 选择 左 。 名 称 选 择 堪 决定 它们 眉 饰 
的 方法 是 否 可 用 于 服务 指定 的 操作 名 称 。 方 法 选择 器 决定 具有 匹配 名 称 的 方法 是 否 可 用 于 服 
务 指定 的 操作 。 方 法 选择 器 通常 会 基于 其 他 运行 时 条 件 给 出 啊 应 。 


1. 操作 名 称 选择 器 


操作 名 称 选 择 器 的 基 类 是 ActionNameSelectorAttribute。 该 类 有 上 县 有 一 个 简单 的 结构 ， 如 
下 和 面 的 代码 所 示 : 
public abstract class ActionNameSelectorAttribute : Attribute 
{ 
public abstract Boolean IsValidName (ControllerContext controllerContext, 


String actionName, MethodInfo methodInfo); 
} 


选择 器 的 目的 很 简单 : 检查 指定 的 操作 名 称 是 否 是 用 于 方法 的 有 效 操作 名 称 。 
在 ASPNET MVC 中 ， 只 有 一 个 操作 名 称 选择 器 : ActionName 特性 ， 可 用 于 对 控制 器 方 
法 命名 别称 。 下 面 是 一 个 示例 : 


[ActionName ("Edit")] 
public ActionResult EditViaPost (String customerId) 
{ 


} 


ActionName 特性 的 实现 是 很 寻常 的 ， 如 以 下 代码 所 示 : 
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public sealed class ActionNameAttribute : ActionNameSelectorAttribute 


{ 
public ActionNameAttribute (String name) 
{ 
1f (String.IsNullOorEmpty (name)) 
throw new ArgumentExcept1ion (); 
Name = name; 
} 
public override Boolean IsValidName (ControllerContext controllerContext, 
String actionName, MethodInfo methodInfo) 
{ 
// Check that the action name matches the specified name 
return String.Equals (actionName, Name, StringComparison. 
OrdinalIlIgnoreCase); 
} 
public String Name { get; set; } 
} 


该 特性 的 整体 作用 是 ， 它 会 在 逻辑 上 将 控制 如 方法 草 命 名 为 它 所 适用 的 名 称 。 例 如 ， 在 
前 面 的 示例 中 ， 方 法 名 称 是 EditViaPost， 但 除非 从 路 由 过 程 中 产生 的 操作 名 称 为 Edit， 合 则 
不 会 调用 它 。 


2. 操作 万 法 选择 器 


操作 方法 选择 器 对 开发 人 员 来 说 是 一 个 更 强大 、 更 具 吸 引力 的 工具 。 在 系统 寻找 可 以 处 
理 请 求 的 控制 右 方 法 的 初步 阶段 ， 方 法 选择 器 只 会 指明 茶 指 定 方法 是 否 有 效 。 很 明显 ， 这 类 
选择 器 会 基于 某 些 运行 时 条 件 确定 其 啊 应 。 下 面 是 基 类 的 定义 : 


public abstract class ActionMethodselectorAttribute : Attribute 
{ 


public abstract Boolean IsValidForRequest ( 
ControllercCcontext controllerContext, MethodIinfo methoadInto) ; 
} 


在 ASPNET MVC 中 , 存在 着 不 少 预定 义 的 方法 选择 器 .它们 是 AcceptVerbs、NonAction， 
还 有 几 个 引入 以 简化 编码 (HttpDelete、HttpGet、HttpPost 和 HttpPub 的 HTTP 特定 的 选择 器 。 
让 我 们 看 看 其 中 的 一 些 。 

NonAction 特性 用 来 阻止 修饰 的 方法 处 理 当 前 操作 。 下 面 是 其 如 何 实现 的 代码 : 


public override Boolean IsValidForRequest( 
Controllercontext controllerContext, MethodIinfo methoadInto ) 
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return false-: 


} 
AcceptVerbs 特性 会 接收 列 出 的 作为 参数 的 受 文 持 HITP 动词 , 并 对 照 列表 检查 当前 的 动 
词 。 下 面 是 一 些 详细 代码 


public override Boolean IsValidForRequest( 
ControllerCcontext controllercCcontext, MethodInfo methodInfo) 


1f (controllerContext == null) 
throw new ArgumentNullException ("controllerContext");) 


// Get the (overridden) HTTP method 
Var method = controllerContext .HttpcCcontext .Reduest . 
GetHttpMethodOverride (); 


// Verbs 1s an internal member of the AcceptVerbsAttribute class 
return Verbs.Contains<String> (method, StringComparer. 
OrdinalIgnoreCase); 
} 
注意 GetHttpMethodOverride 方法 的 使 用 是 按照 客户 端的 意图 检索 实际 的 动词 。 该 方法 会 
读 取 名 为 X-HTTP-Method-Override 的 标 头 字段 或 参数 中 的 值 (关于 X-HTIP-Method-Override 的 
更 多 信息 ， 请 参见 http://code.google.com/apis/gdata/docs/2.0/basics. html#UpdatingEntry)。 这 是 
一 个 让 浏览 器 放置 HTTP 动词 的 通用 协议 ， 即 使 物理 请 求 是 GET 或 POST。 该 方法 不 是 在 
HttpRequest 对 象 上 进行 本 地 定义 的 ， 而 是 作为 HttpRequestBase 的 一 种 扩展 方法 添加 到 
ASPNET MVC 中 的 。 
其 他 选择 器 是 直接 根据 AcceptVerbs 实现 的 ， 如 下 所 示 的 用 于 HttpPost 的 代码 : 


Public sealed class HttpPostAttribute : ActionMethodselectorAttribute 


{ 
private static readonly AcceptVverbsAttribute innerAttribute; 
public override bool IsVvalidForRequest( 
ControllercCcontext controllerContext, MethodIinfo methodIinfo) 
{ 
return innerAttribute.IsValidForRequest (controllerContext, 
methodInfo),;} 
} 
} 
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我 们 看 看 如 何 编写 一 个 目 定义 的 方法 选择 需 。 

3. 将 方法 仅 限 于 Ajax 调用 

你 所 需要 的 只 是 一 个 从 ActionMethodSelectorAttribute 继承 的 类 ， 并 重 写 ValidForRequest 
方法 : 


public class AjaxOonlyAttribute : ActionMethodSelectorAttribute 


{ 
public override Boolean IsValidForRequest ( 
Controllercontext controllerContext, MethodIinfo methodIinfo) 


{ 
return controllerContext.HttpContext.Request.IsAjJaxRequest (); 


} 
} 
任何 以 此 特性 标记 的 方法 只 有 在 服务 于 通过 浏览 器 的 XMLHttpRequest 对 象 所 放置 的 调 
用 时 才 会 局 用 。 
[AJjaxonlyl] 
public ActionResult Details (Int32 customerId) 
{ 


Var model = ...; 
return PartialView (model).; 


} 
如 果 尝 试 根据 路 由 调用 一 个 URL， 必 须要 映 冉 到 一 个 Ajax 方法 ， 才 不 会 出 现 寞 第 。 


4. 将 方法 限于 指定 的 提交 按钮 


在 Web Forms 中 , 每 个 页 面 都 有 一 个 单独 的 HTML 表单 ， 而 几乎 每 一 个 表单 都 包含 多 个 
提交 按钮 。 然 而 ， 每 个 按钮 有 其 自身 的 click 处 理 程序 ， 用 于 确定 在 单 击 时 要 采取 的 操作 。 而 
在 ASPNETMVC 中 ,可 以 随 你 所 愿 使 用 无 数 个 HTML 表单 ,每 一 个 都 会 提交 到 不 同 的 固定 
URL。 既然 每 个 HTML 表单 有 两 个 以 上 的 提交 按钮 ， 你 如 何 确定 是 哪 一 个 按钮 被 单 击 了 ? 

在 HTML 级 别 ， 提 交 的 表单 会 上 载 输 入 字段 的 内 容 以 及 一 个 单 击 按钮 回 有 的 名 称 / 值 对 。 
名 称 标记 指 的 是 按钮 的 名 称 特性 ; 值 标记 指 的 是 按钮 的 值 特性 。 可 惜 ， 按 钮 的 值 特性 是 说 明 
文字 。 你 不 能 通过 检查 说 明文 字 可 靠 地 找 出 单 击 了 哪个 按钮 。 至 少 ， 这 要 受 本 地 化 影响 ， 或 
者 如 果 使 用 了 图 片 按 钮 的 话 ， 这 些 就 都 可 以 跳 过 了 。 

在 ASPNET MVC 中 解决 该 问题 的 最 简单 办 法 是 在 表单 中 添加 一 点 javascript 代码 ， 这 
样 在 单 击 每 个 按钮 时 ， 它 便 会 更 改 表 单 的 操作 特性 以 反映 其 名 称 。 下 面 是 一 个 简单 的 带 有 两 
个 输入 字段 和 两 个 提交 按钮 的 HTML 表单 ， 该 表单 用 于 更 新 或 删除 一 些 内 容 : 
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<form name="myForm" id="myForm" method="post"> 
<input type="text™ /> 
<input type="text"™ /> 
<hr /> 
<input type="submit"™" Value="Update" name="updateAction" 
onclick="setAction('update’')})™ /> 
<input type="submit"™" Value="Delete" name="deleteAction" 
onclick="setAction( delete'}™ /> 
</form> 


名 为 setAction 的 JavaScript 函数 执行 以 下 操作 : 


<script type="text/Javascript"> 
function setAction (action) 
document .getElementById ("myForm") .action = action; 
} 
</script> 


这 招 很 管用 ， 但 烦人 的 是 ， 你 必须 在 每 个 ASPNET MVC 应 用 程序 中 为 你 编写 的 每 个 表 
单 重复 添加 此 代码 。 一 个 特 设 的 方法 选择 器 (以 及 内 置 的 ActionName 特性 ) 更 适合 用 来 完成 
这 一 工作 : 


public class OnlyIfPostedFromButtonAttribute : ActionMethodselectorAttribute 
{ 
public String SubmitButton { get; set; } 
public override Boolean IsValidForRequest (ControllerContext 
controllercontext, 
MethodInfo methodIinfo) 


{ 
// Check 1if this request 1s coming through the specified submit button 
Var 0 = controllerContext.HttpContext.Request[SubmitButton]; 
return oO !'= null]l. 

} 


} 


选择 器 会 公开 一 个 公共 属性 ， 通 过 它 可 以 指明 与 方法 关联 的 按钮 名 称 。 在 估算 时 ， 选 择 
句 只 会 在 被 提交 的 表单 数据 集中 寻找 其 伴随 按钮 的 名 称 。 根 据 HTML 的 设计 ， 只 有 当 表 单 
是 通过 单 击 那个 按钮 提交 的 情况 下 才能 找到 匹配 。 让 我 们 看 看 在 下 面 的 控制 器 代码 中 如 何 使 
用 此 选择 器 : 

[HLLPPost 1】 

[ActionName ("Demo")] 

[onlyIfPostedFromButton (SubmitButton = "updateAction"™")] 

public ActionResult Demo Update () 

{ 
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ViewData["ActionName"] = "Update"; 
return View ("demo™);s 


该 代码 解析 如 下 : 调用 程序 只 有 在 请 求 是 POST、 操 作 名 称 是 demo， 并 且 表 单 是 通过 使 
用 名 为 updateAction 的 提交 按钮 来 提交 的 ， 才 可 以 选择 这 种 方法 (Demo Update)。 


8.2.4 构建 动态 的 加 载 筛选 器 


操作 第 选 器 无 疑 是 一 个 强大 的 机 制 ， 开 发 人 员 可 用 来 决定 到 底 如 何 执行 一 个 指定 的 操作 
方法 。 但 是 ， 从 你 目前 所 看 到 的 而 言 ， 操 作 筛选 器 依然 是 一 种 静态 的 机 制 ， 需 要 新 的 编译 和 
部 署 步 又 以 便于 修改 。 让 我 们 探索 一 种 从 外 部 源 动态 加 载 筛选 器 的 方法 。 


1. 筛选 器 的 拦截 点 


盘 选 部 是 在 操作 调用 程序 的 内 部 解析 每 个 操作 方法 的 。 有 两 个 主要 拦截 点 : GetFilters 
和 InvokeActionMethodWithFilters 方法 。 这 两 个 方法 都 被 标记 为 受 保护 的 和 虚拟 的 。 两 个 方 
法 的 签 hr, 名 如 下 : 


protected virtual ActionExecutedContext InvokeActionMethodWithrilters'( 
Controllercontext controllerContext, 
IList<IActionFilter> filters, 
ActionDescriptor actionDescriptor, 
IDictionary<string, object> parameters);} 


protected virtual FilterIinfo Getrilters ( 
Controllercontext controllerContext, 
ActionDescriptor actionDescriptor) 


GetFilters 方法 会 早 一 些 调 用 ， 并 预期 会 返回 用 于 指定 操作 的 所 有 和 希 选 句 列 表 。 在 你 的 目 
定义 调用 程序 中 调用 基 方 法 GetFilters 以 后 ， 便 有 了 用 于 每 个 类 别 的 可 用 筛选 器 的 完整 列表 
四 后 林 、 投 权 和 操作 第 选 器 的 列表 )。 注 意 FilterInfo 类 一 一 System.Web.Mve 中 
个 类 别 的 特定 第 选 器 集合 : 


和信 共 类 


是 供 


public class FilterIinfo 


{ 
// Private members 
public IList<IActionFilter> ActionFilters { get; } 
public IList<IAuthorizationFilter> AuthorizationFilters { get; } 
public IList<IExceptionFilter> ExceptionFilters { get; } 
public IList<IResultFilter> Resultrilters { get; } 
} 
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InvokeActionMethodWithFilters 方法 会 在 与 操作 方法 性 能 有 关 的 处 理 过 程 中 被 调用 ,在 这 
种 情况 下 ， 该 方法 只 接收 操作 筛选 器 的 列表 (那些 在 用 于 方法 的 代码 之 前 或 之 后 执行 的 科 选 
器 )。 

要 构建 一 种 机 制 可 以 让 开发 人 员 更 改 那些 应 用 于 运行 中 方法 的 筛选 器 ， 我 们 的 关注 点 应 
该 集中 在 InvokeActionMethodWithFilters 方法 上 。 


2. 使 用 连贯 代码 添加 操作 筑 选 器 


通过 在 自 定 义 操作 调用 程序 类 中 重 写 InvokeActionMethodWithFilters 方法 ， 就 可 以 使 用 
连贯 代码 来 配置 控制 器 和 带 有 操作 箭 选 器 的 控制 器 方法 。 下 面 的 代码 显示 了 如 何在 Home 控 
制 器 的 Index 代码 中 动态 添加 Compress 特性 : 


protected override ActionExecutedContext InvokeActionMethodWithFilters!( 
Controllercontext controllerContext, 
IList<IActionFilter> filters, 
ActionDescriptor actionDescriptor, 
IDictionary<string, object> parameters) 


{ 
// Add the Compress action filter to the Index method of the Home controller 
if (actionDescriptor.ControllerDescriptor.ControllerName == "Home™ && 
actionDescriptor.ActionName == "Index") 
{ 
// Configure the filter and add to the list 
Var compressFilter = new CompressAttribute (); 
filters.Add (compressFilter); 
} 
// Go with the usual behavior and execute the action 
return base.InvokeActionMethodWithFilters ( 
controllerContext, filters, actionDescriptor, parameters); 
} 


可 以 从 各 个 方面 修改 此 代码 。 例 如， 可 以 支持 区 域 并 检查 控制 器 的 类 型 而 非 名 称 。 此 外 ， 
可 以 读 取 筛 选 右 以 便 从 配置 文件 中 添加 ， 也 可 以 使 用 Ioc 容器 来 解析 它们 。 通 常 来 说 ， 这 种 
方法 使 你 有 机 会 动态 配置 科 选 器 ， 并 且 它 还 可 以 在 控制 器 代码 之 外 保持 特性 。 


3. 自 定义 操作 调用 程序 


让 我 们 稍微 概括 一 下 这 一 概念 。 假 设 你 创建 了 一 个 自 定 义 操作 调用 程序 ， 并 重 写 了 它 的 
InvokeActionMethodWithFilters 方法 ， 如 下 所 示 : 
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protected override ActionExecutedContext InVoKeaAct1lLonMethodW]IthF11ters ( 
Controllercontext controllerContext, 
IL1ist<IActionFilter> filters, 
ActionDescriptor actionDescriptor, 
IDictionary<string, Object> parameters) 


// Load (dynamic—-loading) filters for this action 
Var methodFilters = LoadFiltersForAction (actionDescriptor);} 
1f (methodFilters.Count == 0) 
return base.InvokeActionMethodWithrFilters (controllerContext, 
filters, actionDescriptor, parameters); 


// Apply filter(s) 
foreach (var filter in methodFilters) 


{ 


Var filterIinstance = GetFilterIinstance (filter)}):; 
1f (filterIinstance == null) 
continue: 


// Initialize filter (if params are speciflied) 
InitializeFilter (filter, filterIinstance); 


// Add the filter 
filters.Add (filterIinstance). 


// Ex1it 
return base.InvokeActionMethodWithFilters (controllerContext, 
filters, actionDescriptor, parameters); 


该 代码 包含 了 大 量 的 占 位 符 方法 ， 实 质 上 会 读 取 可 能 在 web.config 文件 中 找到 的 动态 定 

义 的 筛选 器 。 提 供 的 操作 描述 符 用 来 找 出 有 关 当 前 操作 的 信息 。 操 作 详 细 信 息 用 来 读 取 定 义 

筛选 器 相关 的 信忠 自 。 最 后 ， 往 选 器 通过 反射 进行 实例 化 和 初始 化 ， 并 添加 到 用 于 重 写 方 法 的 
中 选 器 集合 。 你 要 负责 web.config 节 的 结构 。 一 段 美观 的 web.config 节 可 能 会 像 下 面 这 样 : 


<dynamicFilters> 
<action name="Home.Test"> 
<filter type="MvcGallery3.Extensions.Filters.CompressAttribute., 
MvcGallery3.Extensions™ /> 
<filter type="MvcGallery3.Extensions.Filters.AddHeaderAttribute, 
MvcGallery3.Extensions"> 
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<param Name="Name™" Value="X-MVCASPectEX" /> 
<param Name="Value"” Value="3222"™ /> 
</filter> 
</action> 
</dynamicFilters> 


可 以 在 本 书 的 同步 源 代码 中 找到 该 动态 加 载 筛选 器 框架 的 实现 。 

4. 注册 自 定义 调用 程序 

每 个 控制 器 都 有 自己 的 通过 公共 属性 公开 的 操作 调用 程序 。 可 以 在 各 个 控制 器 的 构造 函 
数 中 蔡 换 操作 调用 程序 。 如 果 打算 将 自 定义 调用 程序 应 用 于 任何 控制 器 实例 ， 可 以 考虑 将 代 
码 移 到 控制 器 工厂 。 我 常常 采用 一 个 如 下 面 示例 中 所 定义 的 自 定 义 控制 器 基 类 ， 从 那里 获得 
需要 动态 加 载 筛选 器 的 任何 控制 器 : 


public class AxpectController : Controller 


{ 
public AxpectController() 
{ 
ActionInvoker = new AxpectActionInvoker (); 
} 
} 


public class HomeController : AxpectController 


{ 
// Attributes for this method come fromglobal filters defined in global .asax 
// and dynamic-loading filters defined in web.conf1ig. 
public ActionResult Index() 
{ 
return View(); 
} 
} 


使 用 一 个 用 于 控制 右 的 目 定义 基 类 不 是 所有 开发 人 员 都 喜欢 的 一 种 编程 技术 。 这 可 能 有 
几 个 原因 ， 包 括 个 人 偏好 ， 但 通 第 是 因为 单 继承 语言 (比如 微软 C# 和 微软 Visual Basic .NET) 
仅 提 供 一 个 继承 点 ， 它 往往 会 明智 地 将 其 保留 供 以 后 使 用 。 

如 果 不 喜 欢 使 用 控制 堪 基 类 来 月 用 动态 加 载 的 筛选 器 ， 则 可 以 在 筛选 堪 提 供 程序 之 上 构 
建 一 个 普 代 项 。 


5. 通过 仿 选 器 提供 程序 启用 动态 加 载 


OnActionExecuting 方法 是 在 操作 方法 运行 之 前 执行 菜 些 在 先前 已 注册 的 操作 沉 选 器 中 
定义 的 自 定 义 代 码 的 正确 地 方 。 不 过 ， 在 这 个 点 添加 新 的 科 选 器 执行 某 些 目 定 义 代 码 已 经 太 
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晚 了 。 除 了 使 用 自 定义 操作 调用 程序 ， 筷 选 右 提供 程序 也 是 一 个 系统 定义 的 挂 钓 ， 让 你 可 以 
当权 去 行 时 条 件 动态 注册 筛选 者 。 
科 选 右 提 供 程序 是 一 个 实现 下 列 接口 的 类 : 


public interface IFilterProvider 
{ 
IEnumerable<Filter> GetFilters' 
ControllerContext controllerContext, ActionDescriptor actionDescriptor); 


} 


GetFilters 方法 被 操作 调用 程序 调用 ， 为 指定 操作 动态 地 加 载 第 选 器 。 因 此 自 定义 往 选 器 
提供 程序 正 是 实现 不 再 需要 显 式 调整 操作 调用 程序 和 控制 器 类 的 工具 。 需 要 在 global.asax 中 
注册 你 自己 的 节选 器 提供 程序 ， 如 下 所 示 : 


protected vold Application Start () 
{ 
RegisterFilterProviders (FilterProviders.Providers); 


} 


public static void ReglisterFilterProviders (FilterProviderCollection 


providers) 


providers.Add (new DynamicLoadingFilterProvider ()); 


} 


这 是 就 配置 而 言 需要 准备 到 位 的 所 有 代码 。 接 下 来 ， 需 要 在 配置 文件 中 添加 信息 (如 前 面 
的 示例 代码 所 完成 的 )， 并 且 运 行 应 用 程序 。 下 面 十 用 于 策 选 融 近 供 程 序 的 代位 : 


Public class DynamicLoadingFilterProvider : IFilterProvider 


{ 
public IEnumerable<Filter> GetrFilters ( 
ControllerContext controllerContext, ActionDescriptor actionDescriptor) 
{ 
// The method reads from web.config and returnsa collection of Filter objects 
return LoadFiltersFromConfiguration (actionDescriptor); 


public static IList<Filter> LoadFiltersFromConfiguration (ActionDescriptor 
actionDescriptor) 


var methodFilters = LoadFiltersForAction (actionDescriptor); 
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Var filters = new List<Filtery>().; 
foreach (var filterName in methodF1ilters) 
{ 


// Instantlate and initialize the fllter (if params are specified) 
var filterIinstance = GetrFilterInstance (filterName); 
1f (filterIinstance == null) 
continue; 
InitializeFilter (filterName, filterIinstance); 


// Add to the 11st to return 
Var filter = new Filterl(filterIinstance, Filterscope.Action, -1); 
filters.Adqd (filter):; 


return filters:;: 


} 


筛选 器 提供 程序 通过 一 个 封装 类 -Filter 类 一 来 管理 筛选 器 。 该 类 封装 了 实际 的 操作 
筛选 器 实例 ， 外 加 一 个 用 于 顺序 (在 本 例 中 为 -0 和 筛选 器 范围 的 值 。 这 个 范围 在 FilterScope 
枚 举 类 型 中 定义 。 该 类 型 是 一 个 系统 类 型 ， 定 义 如 下 ; 


public enum Filterscope 


{ 
First = 0， // First to run 
Global = 10， // Applies to all controllers/actions 
Controller = 20, // Applies at controller level 
Action = 30, // Applies at action level 
Last = 100 // Last to run 

} 


有 了 筛选 器 提供 程序 、 下 面 的 代码 、 再 加 上 之 前 显示 的 web.config 内 容 ， 调 用 Test 方法 
时 就 会 产生 如 图 8-4 所 示 的 输出 : 


// Dynamically bound to action filters via web.config 
// (Adding a custom header.) 

public ActionResult Test () 

{ 


return View({(); 


} 
在 此 示例 中 ， 我 们 通过 使 用 global.asax 中 的 代码 来 注册 贤 选 右 提 供 程序 。 或者， 可 以 通 
过 使 用 上 自己 的 依赖 性 解析 器 来 注册 往 选 器 提供 程序 。 
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图 8-4 ”通过 动态 添加 筛选 器 来 修改 请 求 的 响应 


8.3 ”操作 结果 类 型 


迄今 人 下 你 在 这 本 书 里 所 看 到 的 大 部 分 示例 中 ， 控 制 右 方法 总 是 返回 一 个 ActionResult 
对 象 。 这 其 实 是 ASPNET MVC 提供 的 代表 操作 结果 的 基 类 。 根 据 用 于 返回 操作 结果 的 方法 
(比如 View、PartialView 方法 等 ), 实际 的 类 型 会 采用 不 同 的 形式 例如, 当 一 个 方法 返回 HTML 
标记 时 ， 实 际 的 操作 结果 类 型 就 是 ViewResult。 

操作 结果 类 型 也 是 在 很 大 程度 上 可 以 自 定义 的 ASPNET MVC 的 一 个 特性 。 所 以 ， 让 我 
们 继续 进行 到 下 一 阶段 ， 考 虑 可 以 处 理 的 用 来 自 定义 操作 结果 的 工具 


8.3.1 ”内置 的 操作 结果 类 型 


当 由 控制 器 操作 方法 返回 的 ActionResult 对 象 进一步 由 操作 调用 程序 处 理 时 ， 会 生成 浏 
览 器 的 响应 并 将 其 写 入 输出 流 。 换 句 话说 ，ActionResult 类 型 ， 以 及 直接 从 它 派生 而 来 的 任 
何 类 型 ， 并 不 代表 被 发 送 到 浏览 器 的 真正 响应 。 它 只 是 一 个 包含 特定 啊 应 数据 (比如 标 头 、 
cookies、 状 态 代 码 、 内 容 类 型 ， 以 及 任何 可 用 于 生成 响应 的 数据 ) 的 封装 类 ， 并 且 它 知 韦 如何 
处 理 这 些 数 据 以 生成 浏览 器 的 实际 啊 应 。 
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ActionResult 对 象 定义 如 下 : 


public abstract class ActionResult 


{ 

protected ActionResult () 

{ 

} 

public abstract void ExecuteResult (ControllerContext context); 
} 


ExecuteResult 方法 提供 了 同 浏 览 右 呈现 结果 的 逻辑 ,为 了 便于 理解 操作 结果 对 象 的 机 制 ， 
查看 几 个 内 置 于 ASPNET MVC 中 的 操作 结果 类 是 很 有 用 的 。 


1. 返回 自 定义 状态 代码 


一 个 最 简单 的 操作 结果 类 是 HttpStatusCodeResult 类 。 此 类 代表 了 一 个 设置 了 特定 HTTP 
状态 代码 和 插 述 的 操作 啊 应 : 


public class HttpstatusCodeResult : ActionResult 


{ 
public HttpstatusCodeResult (Int32 statusCode) : this (statusCode, null) 
{ 
} 
public HttpstatusCodeResult (Int32 statusCode, String statusDescript1ion,) 
{ 
StatusCode = statusCode; 
statusDescription = statusDescription; 
} 
public override void ExecuteResult (ControllerContext context) 
{ 
1f (context == null) 
throw new ArgumentNullException ("context"); 
// Prepare the response for the browser 
context .HttpContext .Response.StatusCode = StatusCode; 
1f (StatusDescription != null) 
context .HttpContext .Response.statusDescription = StatusDescription; 
} 
} 


可 以 看 到 ， 它 所 做 的 只 是 设置 啊 应 的 状态 代码 和 对 啊 应 的 拍 述 。 下 面 显 示 了 如 何 使 用 此 


类 来 返回 一 个 HTTP 403 代码 (Forbidden)， 如 图 8-5 所 示 ， 意 思 是 说 服务 器 理解 此 请 求 ,， 但 有 
充足 的 理由 拒绝 执行 它 : 
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public ActionResult Eorbldden () 
{ 
return new HttpSstatusCodeResult (403); 


| 全 合 http://local 


恒 HTTP 403 Forbidden 


hostb05d/home/forbidden 


二 The website declined to show this webpage 


Most likely causes: 
» This website requlres you to log in. 


What you can try: 
和 Go back to the previous page. 


加 More information 


图 8-5 ”Web 服务 器 拒绝 执行 请 求 
当 你 需要 从 应 用 程序 中 的 几 个 地 方 返 回 相 同 的 状态 代码 时 ， 最 好 将 状态 代码 封装 在 一 个 
自 定义 的 操作 结果 类 中 。 它 并 不 会 带 来 多 大 的 改变 , 却 一 定 会 增加 可 读 性 。 ASPNET MVC 在 
401 代码 (未 经 授权 ) 中 也 遭 循 这 种 模式 ， 并 且 为 你 提供 了 HttpUnauthorizedResult 类 ， 它 是 由 
Authorize 操作 科 选 器 使 用 的 其 中 一 个 类 。 下 面 是 另 一 个 同样 流行 的 404 代码 的 示例 : 


Public class HttpNotFoundResult : HttpStatusCodeResult 


{ 
public HttpNotFoundResult() : this (null) 
{1} 
public HttpNotFoundResult (String statusDescription) : base(404, 
statusDescript1ion) 
{} 
} 


即使 整体 上 简化 了 ， 这 些 类 也 显示 出 了 操作 结果 类 的 核心 结构 。 
2. 返回 JavaScript 代码 


一 个 稍微 复杂 点 的 例子 是 JavaScriptResult 类 。 此 类 提供 了 一 个 公共 属性 
性 一 一 它 包 含 要 写 入 输出 流 的 脚本 代码 (类 似 于 字符 串 )， 如 下 所 示 : 


Script 属 
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public class JavaScrlptResult : ActionResult 
{ 
Public String Script { get; set; } 
public override voild ExecuteResult (ControllerContext context) 


{ 
1f (context == null) 
throw new ArgumentNullException ("context"™"); 


// Prepare the response 
Var response = context .HttpContext .Response; 


response.ContentType = "application/x-Javascript"; 
1f (Script != null]l) 
response.Write (Script); 


} 
从 如 下 所 示 的 操作 方法 中 使 用 JavaScriptResult 类 : 


public ActionResult Javascript () 


{ 
Var script = "function helloWworld() {alert('"'hello, world!l');}"; 
Var result = new JavaSscriptResult {Script = script}; 
return result; 

} 


对 于 一 些 预 定义 的 操作 结果 ，ASPNET MVC 提供 了 帮助 器 方法 ， 它 们 隐藏 了 操作 结果 
对 象 的 创建 过 程 。 可 以 以 更 简洁 的 方式 重 写 前 面 的 代码 ， 如 下 所 示 : 


public ActionResult Javascript () 


{ 
Var script = "functlon helloWworld() {alert ('hello, world!i'});}"; 


return JavaSscript (script); 
} 
当 用 户 调 用 一 个 返回 JavaScript 的 操作 时 ， 就 会 显示 如 图 8-6 所 示 的 经 典 下 载 面 板 。 
事实 证 明 操 作 方 法 返回 JavaScript 的 正确 位 置 是 <script> 标 记 。 
<script type="text/Javascript™" src="/home/Javascript"></script> 


加 上 一 行 如 在 刚才 的 HTML 中 所 示 的 代码 以 后 , 就 可 以 以 编程 方式 调用 正在 下 载 的 任何 
脚本 函数 了 。 
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Do you want to open or save javascriptjs (47 bytes) from localhost? 


Open | Save 


图 8-6 ”由 JavaScript 操作 结果 返回 的 脚本 代码 
3. 返回 JavaScript 对 象 标记 数据 


要 从 ASPNET MVC 控制 器 类 内 部 返回 JavaScript 对 象 标记 (JSON) 数 据 ， 你 只 需要 一 个 
返回 JsonResult 对 象 的 操作 方法 。JsonResult 类 会 获取 任意 .NET 对 象 ， 并 尝试 通过 使 用 
JavaScriptSerializer 系统 类 将 其 序列 化 为 JSON。 下 面 是 对 服务 JSON 数据 的 操作 方法 的 一 个 
可 能 定义 : 

public JsonResult GetCountries (String area) 

// Grab some data to serialize and return 

Var Countries = CountryRepository.GetAll (area); 
return Json (countries); 

} 

Json 方法 是 在 Controller 类 上 定义 的 ， 它 会 在 内 部 创建 一 个 JsonResult 对 象 。JsonResult 
对 象 的 目的 是 要 将 指定 的 .NET 对 象 一 一 在 本 示例 中 是 一 份 国家 名 单一 一 序列 化 为 JSON 格 
式 。Json 方法 有 几 个 重 载 , 通过 它们 可 以 指定 所 需 的 内 容 类 型 字符 串 ( 默 认为 application/json)， 
并 请 求 行为 。 请 求 行为 包括 通过 HTTP GET 请 求 允许 或 拒绝 JSON 内 容 。 

默认 情况 下 ，ASPNET MVC 不 通过 HTTP GET 请 求 来 提供 JSON 内 容 。 这 意味 着 如 果 
前 面 的 代码 是 在 一 个 GET 上 下 文中 调用 的 ， 则 会 执行 失败 ， 而 这 是 进行 JSON 调用 的 最 明显 
的 方式 。 如 果 认 为 你 的 方法 是 安全 的 ， 不 会 有 潜在 的 泄露 敏感 数据 的 风险 ， 你 就 可 以 修改 代 
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public JsonResult GetCountries () 


{ 

// Grab some data to serialize and return 

Var Countries = CountryRepository.GetAll (); 

return Json(countries, JsonRequestBehavior.AllowGet).; 
} 


就 像 脚 本 一 样 ， 如 果 操 作 方 法 通过 浏览 器 以 交互 方式 调用 ， 则 从 该 方法 返回 的 JSON 数 
据 就 会 被 下 载 。 如 果 将 操作 方法 能 入 到 <scrip 人 标记 或 通过 Ajax 调用 ， 内 容 就 可 被 用 作 原 始 
数据 。 下 面 的 脚本 显示 了 通过 ASPNET MVC 控制 器 下 载 JSON 数据 的 一 个 Ajax 调用 。 下 载 
的 数据 随后 会 被 用 来 填充 一 个 名 为 listOfCountries 的 下 拉 列 表 。 


function downloadCountries (area) 1{ 
$s ("#1istofcountries") .empty (); 


$s .getJSsSON("/home/getcountries", { area: "EMEA" }, 
function (data) { displayCountries (data); }); 


} 


function displayCountries (data) { 
// Get the reference to the drop-down list 
Var listbox = $ ("#1l1istofCountries"™)} [01; 


// F1ill the 11st 
for (var 1 = 0; 1 < data.length; 1++) ({ 
Var country = datal[lil]; 
var option = new Option (country.Name, country.Code).,; 
11stbox.add (option}); 
}s 
} 


该 视图 中 的 HTML 看 起 来 如 图 8-7 所 示 。 

4. 返回 基本 类 型 

严格 地 讲 ， 控 制 器 操作 方法 不 会 被 强制 返回 一 个 ActionResult 对 象 。 例 如 ， 可 以 让 它 返 
回 一 个 字符 串 或 者 一 个 整数 , 以 及 在 方法 签名 中 作为 声明 的 返回 类 型 的 String 与 Int32。 然而 ， 
请 注意 ,无 论 你 返回 什么 类 型 ,都 会 被 ASPNET MVC 框架 封装 在 一 个 ContentResult 对 象 中 。 

相反 ， 如 果 是 虚 方 法 ， 操 作 结果 就 会 是 一 个 EmptyResult 对 象 。 通 过 使 用 操作 筛选 器 ， 
可 以 随意 修改 结果 对 象 及 它 的 参数 。 所 以 最 终 , 你 仍然 可 以 声明 控制 器 方法 不 返回 任何 内 容 ， 
而 是 定制 成 返回 一 个 附加 有 操作 筛选 器 的 以 编程 方式 返回 一 个 指定 结果 对 象 的 值 。 
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| > | 压 https/ /localhost 6015/ 


8-7 由 Ajax 检索 的 JSON 数据 填充 的 下 拉 列 表 
8.3.2” 自 定义 结果 类 型 


归根 结 邱 ， 操 作 结 果 对 象 是 封装 需要 在 特殊 情况 下 完成 的 所 有 任务 的 一 种 方式 ， 比 如 当 
请 求 的 资源 丢失 或 被 重 定 回 时， 或 者 当 茶 些 特殊 的 啊 应 必须 提供 给 浏览 器 时 。 让 我 们 检查 几 
个 具有 目 定 义 操作 结果 对 象 的 相关 方案 。 


1. 返回 JSONP 字符 串 


你 可 能 知道 ， 浏 览 器 通常 不 允许 页 面 放置 会 调用 男 一 个 域 的 网 站 的 Ajax。 此 规则 是 相对 
较 新 的 ， 添 加 它 用 来 将 恶意 用 户 的 表面 攻击 区 域 减少 到 零 。 这 种 限制 的 实际 效果 是 ， 阻 止 对 
网 站 (承载 在 不 同 的 域 而 非 请 求 页 面 ) 进 行 Ajax 调用 并 下 载 JSON 数据 。 更 有 意思 的 是 ， 这 一 
限制 单方 面 被 浏览 器 采用 ， 却 忽略 了 远程 站 点 能 售 提 供 数据 。 

这 对 Ajax 调用 和 JSON 数据 来 说 还 真是 麻烦 , 但 我 们 仍然 不 能 控制 可 以 从 任何 可 访问 网 
站 随意 下 载 的 图 片 和 脚本 文件 . 正 是 浏览 器 的 这 一 特点 可 以 被 利用 来 通过 Ajax 从 显 式 允 许 的 
站 点 安全 地 下 载 JSON 数据 。 这 就 是 JSONP( 带 填充 的 JSON) 协 议 的 核心 内 容 。 

JSONP 是 某 些 网 站 用 来 公开 其 JSON 内 容 的 一 项 协议 ， 这 是 以 一 种 让 调用 方 更 易于 通过 
脚本 甚至 从 外 部 域 使 用 数据 的 方式 来 公开 的 。 其 原理 是 返回 封装 在 一 个 脚本 函数 调用 中 的 
JSON 内 容 。 换 句 话 说 ， 网 站 会 返回 下 面 的 字符 串 ， 而 非 包含 普通 JSON 数据 的 字符 串 : 


yourFunction("{...}"); // instead of plaln {...} JSON data 


从 <script> 标 记 中 调用 网 站 URL 后 ， 浏 览 器 会 收 到 一 个 带 有 固定 输入 字符 串 的 看 起 来 像 
普通 函数 的 调用 。 这 时 ， 输 入 数据 是 文本 还 是 JSON 文本 对 浏览 器 来 说 已 经 没有 关系 了 。 
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文 持 JSONP 的 网 站 会 公开 一 个 用 于 调用 的 公共 方式 , 指明 在 返回 JSON 数据 时 要 使 用 的 
JavaScript 困 数 的 封装 名 称 。 无 顷 多 说 , JavaScript 图 数 对 发 出 请 求 的 站 点 来 说 必须 是 本 地 的 ， 
并 且 应 该 要 包含 处 理 JSON 数据 的 馆 辑 。 让 我 们 看 看 如 何在 ASPNET MVC 控制 问 中 添加 
JSONP 功能 。 请 思考 下 面 的 示例 : 


public ActionResult GetCountriesJsonp (String area) 
{ 
Var result = new JsonpResult 
{ 
JsonRequestBehavior = JsonRequestBehavior.AllowGet, 
Data = GetCountries (area) 
}; 
return result; 


} 
JsonpResult 类 扩展 了 本 地 JsonResult， 并 将 正在 返回 的 JSON 字符 串 封装 成 一 个 对 指定 
JavaScript 国 数 的 调用 。 


Public class JsonpResult : JsonResult 
{ 

// The callback name here 1s the parameter name to be added to the URL to 
specify the name of the Javascript function padding the JSON response. This name 
1s arbitrary and is part of your site's SDK. 

private const String JsonpCallbackName = "callback"; 


public override vold ExecuteResult (ControllerCcontext context) 
{ 
1f (context == null) 
throw new ArgumentNullException ("context"™"); 


if ((JsonRequestBehavior == JsonRequestBehavior.DenyGet) && 
string.Equals (context .HttpContext.Request.HttpMethod, "GET") ) 
throw new InvalidOoperationException (); 


var response = context.HttpContext .Response; 
1f (!String.IsNullorEmpty (ContentType)) 
response.contentType = ContentType; 


else 
response.ContentType = "application/Json"; 
1f (ContentEncoding != null) 


response.ContentEncoding = this.ContentEncoding; 


1f (Data != null) 
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String buffer; 
Var request = Context .HttpContext .Request,; 
Var Serlallzer = new JavaSscriptSerializer(); 
1if (request[JsonpCallbackName] != null) 
buffer = String.Format ("{0} ({1})", request[JsonpCallbackName], 
Serializer.Serialize (Data)}: 


else 
buffer = serializer.Serialize (Data); 


response.Write (buffer); 


} 

这 个 类 与 JsonResult 几乎 是 相同 的 ， 除 了 在 ExecuteResult 方法 中 有 一 点 小 变化 以 外 。 在 
序列 化 为 JavaScript 之 前 ， 该 代码 会 检查 常规 的 JSONP 参数 是 否 已 经 通过 请 求 并 相应 地 确定 
了 JSON 字符 串 。 图 8-8 显示 了 以 下 URL 的 啊 应 正文 : 


/home/Vgetcountrles]jsonp?callback= CacheForLater&area=asla 


File Find Disable View lmages Cache Tools Validate | 


Browser Mode: IE10 Document Mode: Standards [加 
HTML ”CSS Console Script Profiler| Nebwork |3earch Captured Troffic... 


RN mi lH | Stop capturing | | Backto summary view | <Prev | 1/1 | Net> |Clear | 
URL: http: /Mocalhost: 56015hhomejgetcountriesjonpycallback= cacheForLater Barea=asia 
| io | |, : = | 
| Request headers | Request body | Response headers Response body | Cookies Initiator | Timings 
1i cacheForLater([{"Code":"CC","Area":"Asia”,"Name":"China”,"Capital”:"Beijing"}, 
i {"Code™”:"JP","Area”:"Asia”,"Name”:"Japan”,"Capital”:"Tokyo"}]) 


图 8-8 ”通过 正 开 发 者 工具 栏 浏览 的 JSONP 视图 


要 放置 一 个 JSONP 调用 ， 可 以 遵循 几 条 路 由 。 例如， 可 以 手动 设置 一 个 <script> 标 记 ， 
使 JSON 数据 对 页 面 全 局 可 用 : 

<sCcript type="text/Javascript" 

src="/home/getcountries]jsonp?callback= cacheForLaterg&area=aslia"> 
</script> 

或 者 ， 可 以 通过 jQuery 或 普通 的 JavaScript 发 起 一 个 Ajax 调用 。 尤 其 是 ，jQuery 库 可 以 
通过 getJSON 函数 提供 具体 的 文 持 。 当 你 传递 给 getJSON 的 URL 包含 一 个 xxx =? 段 时 ,jQuery 
就 会 将 其 解释 为 JSONP 调用 并 以 一 种 特殊 方式 处 理 它 。 更 确切 地 说 , jQuery 会 动态 创建 一 个 
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<script> 标 记 ， 并 通过 它 下 载 啊 应 。 填 充 函 数 的 名 称 会 通过 jQuery 动态 生成 ， 并 且 会 被 指 回 
你 提供 的 gsUSON 回调 代码 。 下 面 是 一 个 示例 : 


$.getJSON("/home/getcountriesjsonp?callback=?", { area: "NA" }, 
function (data) { displayCountries (data); }); 


URL 中 的 回调 名 称 必须 与 你 调用 的 网 站 所 定义 的 公共 JSONP 名 称 相 匹 配 。 我 在 这 个 示 
例 中 使 用 回调 是 因为 那 是 由 先前 提供 的 JsonpResult 实现 所 识别 的 名 称 。 


2. 返回 联合 源 


如 果 在 网 络 中 搜索 一 个 不 寻 钊 的 操作 结果 的 例子 ， 很 可 能 会 在 搜索 列表 的 顶部 找到 一 个 
联合 操作 结果 对 象 。 让 我 们 简单 地 看 看 这 个 流行 的 例子 。 

SyndicationResult 类 支持 RSS 2.0 和 AIOM 1.0， 它 为 你 提供 了 一 个 方便 的 属性 可 以 以 编 
程 方式 选择 其 中 的 一 个 。 上 默认 情况 下 ， 该 类 会 生成 RSS 2.0 源 。 要 编译 此 示例 ， 你 需要 引用 
System.ServiceModel 程序 集 并 导入 System.ServiceModel.Syndication 名 称 空间 : 


public class SyndicationResult : ActionResult 
{ 
public SyndicationFeed Feed { get; set; } 
public FeedType Type { get; set; } 


public SyndicationResult () 
{ 
Type = FeedType.Rss; 
} 
public SyndicationResult( 
string title, string description, Uri uri, IEnumerable 
<SyndicationItem> items) 


{ 
Type = FeedType.Rss; 
Feed = new SyndicationFeed (title, description, uri, litems); 
} 
public SyndicationResult (SyndicationFeed feed) 
{ 
Type = FeedType.Rss; 
Feed = feed; 
} 


public override void ExecuteResult (ControllerContext context) 
{ 
// Set the content type 
context .HttpContext .Response.ContentType = GetContentType () 7 
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// Create the feed, and write it to the output stream 


Var feedrFormatter = GetFeedrFormatter (); 
Var writer = XmlWriter.Create (context .HttpContext .Response.Output) ; 
1f (writer == null) 

return; 


feedFormatter .WriteTo (writer):; 
writer.Close(}); 


private String GetContentType () 
{ 
1f (Type == FeedType.Atom) 
return "application/atom+xml™; 
return "application/rsst+xml™"; 


private SyndicationFeedFormatter GetFeedFormatter () 
{ 
1f (Type == FeedType.Atom) 
return new Atoml0O0FeedFormatter (Feed); 
return new Rss?0FeedrFormatter (Feed).;} 


public enum FeedType 
{ 

Rss = 0, 

Atom = 1 
} 


该 类 会 得 到 一 个 联合 源 ， 并 通过 使 用 RSS 2.0 或 ATOM1.0 格式 将 其 序列 化 到 客户 端 。 创 
建 一 个 可 使 用 的 源 就 是 男 一 回 事 了 ， 但 它 也 是 一 个 涉及 控制 器 而 不 是 基础 架构 的 问题 。 下 面 
显示 了 如 何 编写 一 个 返回 源 的 控制 器 方法 : 


Public SyndicationResult Feed ( ) 
{ 
var ltems = new List<SyndicationItem> (); 
items.Add (new SyndicationItem! 
"Controller descriptors", 
"This post shows how to customize controller descriptors", 
null}))}):; 
items.Add (new SyndicationItem! 
"Action filters"™, 
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"Using a fluent API to define actlon filters", 
null}y}):; 

items.Add (new SyndicationItenm ( 
"Custom action results" 


"Create a custom action result for syndication data", 


null))}); 

Var result = new SyndicationResult( 
"Programming ASP.NET MVC"™, 
"Dino's latest book", 

Request .Url|l, 
1 七 ems) ; 


result.Type = FeedType.Atom; 
return result; 


} 


你 要 创建 一 个 SyndicationItem 对 象 的 列表 ， 并 为 其 中 的 每 一 个 提供 标题 、 内 容 和 一 个 备 
用 链接 (在 代码 片段 中 为 nulD)。 通 第 要 从 应 用 程序 中 可 能 有 的 一 些 存 储 库 中 检索 这 些 项 。 最 后 ， 
将 这 些 项 传递 给 SyndicationResult 对象， 顺带 着 标题 和 对 将 要 创建 并 序列 化 的 源 的 摘 述 。 图 


8-9 显示 了 一 个 正中 的 AIOM 源 。 


要 a 2 http://localhost:56015/home/feed 


Programming ASP.NET MVC 

You are viewing a feed that contains frequently updated content. When you 
subscnibe to a feed, it is added to the Common Feed List Updated information 
from the feed is automatically downloaded to your computer and can be viewed in 
Internet Explorer and other programs,. Learn more about feeds, 


哈 Subscribe to this feed 


Controller descriptors 
Today, March 31, 2013, 1103:30 AM 


This post shows how to customize controller descriptors 


Action filters 
Today, March 31, 2013, 11:03:30 AM 
Using a fluent API to define action filters 


Custom action results 


Today, March 31, 2013, 11:03:30 ANM 


Create a custom action result for syndication data 


图 8-9 显示 在 正中 的 ATOM 源 
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3. 处 理 二 进 制 内 容 


开 友 人 员 的 第 见 需求 是 从 请 求 返 回 二 进 制 数据 。 许 多 不 同类 型 的 数据 均 是 以 二 进 制 数 据 
来 表示 的 ， 比 如 图 片 的 像素 、PDF 文件 的 内 容 ， 甚 至 是 微软 的 Silverlight 程序 包 。 

你 并 不 真 的 需要 一 个 特 设 的 操作 结果 对 象 来 处 理 二 进 制 数 据 。 在 内 置 的 操作 结果 对 象 
中 ， 你 肯定 可 以 找到 在 处 理 二 进 制 数 据 时 能 够 帮助 到 你 的 那个 对 象 。 如 果 要 转换 的 内 容 存 储 
在 磁盘 文件 中 ， 则 可 以 使 用 FilePathResult 对 象 。 如 果 内 容 可 以 通过 数据 流 获取 ， 就 使 用 
FileStreamResult 并 选择 FileContentResult， 如 果 可 以 让 它 用 作 字 节 数 组 的 话 。 

所 有 这 些 对 象 都 从 FileResult 派生 ， 只 是 在 如 何 将 数据 写 出 到 啊 应 流 方面 相互 不 同 。 让 
我 们 回顾 一 下 ExecuteResult 在 FileResult 内 是 如 何 实现 的 。 


public override void ExecuteResult (ControllerContext context) 


{ 
1f (context == null) 
throw new ArgumentNullException ("context"); 


Var response = context.HttpContext.Response; 
response.ContentType = this.ContentType; 
1f (!String.IsNullOorEmpty (this.FileDownloadName)) 
{ 
Var headerValue = ContentDispositionUt11. 
GetHeaderValue (FileDownloadName):; 
context .HttpContext.Response.AddHeader ("Content-Disposition"™, 
headerValue):; 


} 


// Write content to the output stream 
Writerile (response); 
} 
该 类 有 一 个 名 为 ContentType 的 公共 属性 ， 通 过 它 可 以 与 MIME 类 型 的 啊 应 通信 ， 这 种 
啊 应 的 所 有 工作 都 是 通过 一 种 抽象 方法 一 一 WriteFile 一 一 来 进行 的 ， 从 WriteFile 派生 的 类 都 
必须 重 与 。 
基 类 FileResult 还 通过 Content-Disposition 标 头 支持 客户 端 浏览 器 中 的 Save As 对 话 框 。 
FileDownloadName 属性 会 指定 文件 将 在 浏览 器 中 的 Save As 对 话 框 中 给 出 的 默认 名 称 。 
Content-Disposition 标 头 具有 如 下 格式 ， 其 中 XXX 代表 FileDownloadName 属性 的 值 : 


Content-Disposition: attachment filename~XXX 


注意 文件 的 名 称 应 该 在 US-ASCII 字符 集中 ， 人 允许 没有 目录 路 径 信息 。 最 后 ，MIME 类 
型 一 定 是 对 浏览 器 未 知 的 ; 否则 ， 将 使 用 注册 的 处 理 程 序 来 处 理 内 容 。 
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基 类 FileResult 与 派生 的 类 之 间 的 差异 主要 涉及 WriteFile 方法 的 实现 。 尤 其 是 ， 
FileContentResult 会 将 字 节 数组 直接 写 入 输出 流 ， 如 下 所 示 : 


// FileContents 1s a property on FileContentResult that points to the bytes 
protected override void Writerile (HttpResponseBase response) 
{ 

response.Ooutputstream.Write (FileContents, 0, FileContents.Length);) 


} 


FileStreamResult 提供 了 一 个 不 同 的 实现 。 它 有 一 个 FileStream 属性 , 提供 了 数据 的 读 取 ， 
有 WriteFile 中 的 代码 会 以 缓冲 的 方式 读 写 。 


protected override Vold WriterFile (HttpResponseBase response) 


{ 
Stream outputstream = response.outputstream; 
using (FileSstream) 
{ 
bytel[] buffer = new bytel[l0x1000]; 
while (true) 
{ 
Var count = FileStream.Read (buffer, 0, 0xl1000); 
1f (count == 0) 
return; 
outputstream.Write (buffer, 0, count); 
} 
} 
} 


最 后 ，FilePathResult 会 将 现 有 文件 复制 到 输出 流 。WriteFile 的 实现 语句 在 这 种 情况 下 是 
相当 短 的 。 


// FileName 1s the name of the file to read and transmit 
protected override Vold Writerile (HttpResponseBase response) 
{ 

response.TransmitFile (FileName):; 


} 


有 了 这 些 可 用 的 类 ， 你 就 可 以 处 理 任何 形式 的 需要 从 URL 以 编程 方式 提供 的 二 进 制 数 
据 。 下 面 的 代码 显示 了 如 何 提供 一 个 图 片 : 


public ActionResult Img () 
{ 
const String file = "stones.1p9g"; 
return File (Server.MapPath (String.Format ("~/content/images/{0}", file)), 
"Image/Jpeg"); 
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} 
4. 返回 PDF 文件 


作为 最 后 一 个 例子 ， 我们 看 看 怎样 才能 返回 一 些 PDF 数据 。 老 实说 ， 到 这 一 步 ， 要 解决 
的 最 大 问题 是 你 如 何 获 取 PDF 内 容 。 如 果 PDF 内 容 是 静态 资源 ， 比 如 服务 器 文件 ， 那 么 只 
需要 使 用 FilePathResult 即 可 。 更 好 的 是 ， 可 以 使 用 特 设 的 File 方法 ， 如 下 所 示 : 

public ActionResult About () 

{ 

return File (fileName, "application/pdf"); 

} 

要 动态 创建 PDF 内 容 ， 可 以 使 用 许多 库 ， 比 如 iTextSharp (参见 http://sourceforge.net/ 
Projects/itextsharp)。 一 些 商 业 产品 以 及 各 种 开源 项 目 也 可 以 从 HIML 内 容 创建 PDF 内 容 。 这 
个 选项 对 于 ASPNET MVC 应 用 程序 来 讲 尤其 有 用 ， 因 为 可 以 搬 取 一 个 局 部 视图 ， 将 其 变 成 
可 下 载 的 PDF 内 容 。 

更 遇见 的 情形 和 是， 你 需要 创建 并 返回 从 模板 改编 的 PDF 文档 。 有 两 种 主要 的 方式 可 以 考 
谍 : 使 用 Office 目 动 化 并 且 从 微软 Word 或 Excel 文档 创建 PDF; 或 者 使 用 Reporting Services。 
两 相 比 较 ， 使 用 做 软 Office 也 许 更 易于 进行 ; Reporting Services 则 各 菲 ， 并 且 可 以 免除 隐 
藏 的 成 本 和 不 易 察觉 的 问题 。 顺 融 说 一 下 ， 人 微软 本 号 不 鼓励 在 服务 器 应 用 程序 中 使 用 Office 
目 动 化 (参见 http://support.microsoft.com/?1d=257757)。 我 已 经 将 其 用 于 几 个 应 用 程序 且 并 没 
有 得 遇 任何 严重 的 问题 。 但 是 ， 我 的 经 验 可 能 是 个 例 而 非 通用 法 则 。 

本 书 的 同步 代码 提供 了 一 个 示例 的 ASPNET MVC 项 目 , 当 你 调用 一 个 指定 操作 方法 时 ， 
它 就 会 提供 一 个 PDF 文件 ,该 代码 使 用 了 Office 自动 化 , 从 DOTX 模板 创建 新 的 Word 文档 。 
该 模板 包 侣 了 一 些 以 编程 方式 将 换 为 用 户 定 义 值 的 书签 。 图 8-10 显示 了 由 前 面 的 代码 所 创建 
的 示例 PDF 文档 。 


注意 : 

示例 PDF 应 用 程序 是 通过 在 Web 服务 器 磁盘 上 创建 本 地 文件 来 工作 的 。 只 要 你 是 通过 
使 用 微软 Wisual Studio 环境 (以 及 页 入 式 的 Wisual Studio Web 服务 器 ) 来 测试 应 用 程序 ， 一 切 
都 会 很 顺利 。 当 你 是 在 真正 的 IIS Web 服务 器 下 开始 测试 时 ， 由 于 默认 的 安全 权限 ， 本 地 保 
存 文件 可 能 会 引发 一 些 问 题 。 ASPNET 默认 账户 并 不 会 在 创建 该 文件 的 文件 夹 上 具有 写 入 权 
限 。 要 解决 此 问题 ， 需 要 提高 ASPNET 账户 在 你 打算 创建 临时 或 持久 的 PDF 文件 的 文件 夹 
中 的 写 入 权限 。 
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‘localhost:s7109/home pdf 


Your document 


This document has been created Sunday, 31 March 2013 @ 03:48. Further revisions will follow up 
shortlhy. 


Nunc feugiat aliquam massa, sed feugiat urna molestie id. Suspendisse potenti. Maecenas mattis 

tincidunt nisi. Duis semper tincidunt turpis, at semper eros iaculis sed. Etiam leo arcu, faucibus ut 
pulvinar nec, laoreet eget massa. Nunc egestas pellentesque tortor eget pulvinar. Phasellus faucibus 
volutpat nibh ornare tristique. Aenean ullamcorper varius enim vel convallis. Aenean magna ipsum, 
sollicitudin at feugiat quis, dignissim vitae massa. Integer ut quam sit amet nulla auctor iaculis ac quis 
neque. 


| orem ipsum dolor sit amet, Consectetur adipiscting elit. Morbi luctus dui id nunc viverra wulputate. 


Yours sincerely 


Dino Esposito 


图 8-10 动态 创建 PDF 文档 的 示例 应 用 程序 
8.4 本章 小 结 


不 论 你 是 否 喜 欢 ASPNET MVC， 都 不 能 售 认 它 是 一 个 高 度 自 定义 和 可 扩展 的 框架 。 在 
ASPNET MVC 中 ， 可 以 充 分 控制 每 个 操作 的 执行， 并 且 在 请 求 被 处 理 之 前 以 及 被 处 理 之 后 
进行 干预 。 同样 , 对 于 发 出 对 客户 端 浏览 器 的 啊 应 的 过 程 , 你 几乎 可 以 获得 所 有 方面 的 控制 权 。 

即使 可 以 自 定义 ASPNET MVC c 的 每 -个 方面 ， 也 不 会 总 想 对 它们 进行 重 写 。 这 一 章 中 
所 讨论 的 自 定义 方面 是 那些 我 认为 常 被 自 定义 的 方面 ， 以 及 更 重要 的 是 ， 那 些 能 带 来 巨大 收 
益 的 方面 ， 如 果 能 够 恰当 地 自 定义 的 话 。 
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在 准备 作战 时 我 总 是 发 现 计划 一 无 是 处 ， 但 计划 却 是 必 不 可 少 的 。 
——Dwight D. Fisenhower 


在 NET 刚 推出 时 , 应 用 程序 的 平均 复杂 性 并 不 是 很 高 ， 微软 Visual Studio 调试 工具 就 足 
以 用 来 达成 测试 目的 了 。 快 速 应 用 程序 开 友 (Rapid Application Development，RAD) 是 大 多 数 
人 选择 的 范式 ; 随 之 而 来 的 就 是 ， 很 省 有 开发 人 员 会 去 关心 编写 测试 程序 了 。 

.NET 平台 的 成 功 使 整个 行业 范围 的 许多 企业 都 需要 获取 新 的 业务 应 用 程序 。 这 样 一 来 ， 
他 们 就 抛 痉 了 大 量 的 基于 不 同 开发 团队 的 各 种 复杂 性 和 业务 规则 。 在 只 有 RAD 范式 文 持 的 

育 况 下 ， 生 产 力 的 提高 变 得 越 来 越 难 。 这 最 终 导 致 了 开发 处 理 顺 序 的 完全 变更 。 开 发 人 员 除 
了 要 关注 上 市 时 间 ， 还 必须 更 多 关注 可 维护 性 和 可 扩展 性 。 当 然 ， 可 维护 性 也 市 来 了 对 代码 
可 读 性 的 要 求 ， 以 处 理 日 益 增 长 的 需求 变化 。 

测试 软件 的 能 力 ， 尤 其 是 自动 测试 软件 的 能 力 ， 是 非常 重要 的 一 个 方面 ， 因 为 自动 化 测 
试 给 了 你 -种 机 械 方式 ， org de -时 点 运 行 的 茶 些 功能 在 做 了 了 一些 更 改 之 

后 是 否 仍 然 在 正常 运行 。 此 外 ， 测 试 还 使 你 有 可 能 计算 出 指标 并 时 时 把 握 项 目的 脉 捕 。 归 根 
Oh 

无 可 人 否认 生产 力 非 常 重要 ， 但 仅仅 把 重点 放 在 生产 力 上 成 本 太 高 ， 因 为 它 会 导致 难以 维 
护 的 低 质量 代码 ， 维 护 费 用 也 相当 昂贵 。 所 以 如 果 是 这 样 的 话 ， 又 有 什么 好 处 呢 ? 

用 目 动 化 方式 测试 软件 的 必要 性 一 一 我 们 可 以 称 之 为 采用 RAD 人 :要 性 
提出 了 男 一 个 关键 点 : 拥有 易于 测试 的 软件 的 必要 性 。 在 这 一 ee 
有 可 测试 性 所 需 的 技术 特点 。 接 下 来 ， 介绍 单元 测试 的 基本 知识 _ 固件 、 断 言 、 测 试 蔡 刁 
和 代码 履 盖 率 一 一 最 后 以 一 些 特定 于 ASPNET MVC 的 单元 测试 的 例子 结束 。 


注意 : 
很 长 时 间 以 来 ， 许 多 .NET 开发 人 员 都 把 “测试 ”和 “调试 ”这 样 的 术语 看 作 是 同义词 。 
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调试 的 操作 涉及 捕捉 和 修复 应 用 程序 中 的 错误 和 异常 。 调 试 由 一 名 开发 人 员 实施 ， 且 大 多 是 
交互 的 多 阶段 过 程 。 而 测试 的 操作 涉及 确保 代码 某 些 部 分 的 表现 如 预期 那样 运行 。 测 试 由 特 
设 程序 实施 ， 本 质 上 是 无 人 值守 的 任务 ， 它 是 自动 执行 且 集成 在 软件 的 构建 过 程 中 的 。 这 两 
个 进程 是 正 交 的 ， 相 互 之 间 并 不 排斥 。 测 试 会 是 重 现 bug 的 有 效 办 法 ; 另 一 方面 ， 它 又 能 很 
好 地 设法 预防 bug 的 出 现 . 


9.1 可 测试 性 和 设计 


在 软件 架构 的 上 下 文中 ， 对 于 可 测试 性 一 个 广泛 认可 的 定义 是 “执行 测试 的 容易 程度 ”。 
测试 ， 当 然 是 对 软件 的 检查 过 程 ， 确 保 软件 表现 一 如 预期 、 不 包含 错误 、 并 且 满 足 需求 。 

测试 软件 在 概念 上 很 简单 : 强制 程序 作用 于 正确 的 、 错 误 的 、 技 失 的 或 不 完整 的 数据 ， 
并 验证 结果 是 否 符合 预期 。 那 么 如 何 强 制程 序 作 用 于 你 的 输入 数据 呢 ? 如 何 衡量 结果 的 正确 
性 呢 ? 在 失败 的 情况 下 ， 你 如 何 跟踪 是 哪个 特定 模块 造成 了 失败 呢 ? 

这 些 问 题 都 是 可 测试 性 设计 (DfT) 范 式 的 基础 ,任何 充分 考虑 了 DfT 原则 的 软件 其 本 身 都 
是 可 测试 的 ， 作 为 一 个 令 人 愉快 的 附属 产物 ， 它 也 是 易于 阅读 和 理解 ， 可 有 助 于 以 后 日 常 维 
护 的 。 


重要 提示 : 

从 我 个 人 来 看 ， 可 测试 性 远 比 测 试 本 身 要 重要 得 多 。 可 测试 性 是 软件 的 一 个 特性 ， 它 代 
表 了 与 软件 质量 有 关 的 一 个 (重大 的 ) 声 明 。 测 试 是 一 个 旨 在 验证 代码 是 否 满足 期 望 的 过 程 。 
运用 可 测试 性 (例如 ， 让 你 的 代码 荔 于 测试 ) 就 像 是 学 习 捕 鱼 ; 编写 单元 测试 就 像 是 吃 鱼 。 


9.1.1 DfT 


DfT 作为 一 个 普 过 概念 诞生 于 几 十 年 前 一 个 非 软件 行业 的 领域 。 事 实 上 ，DfT 的 目的 是 
为 了 改善 主板 和 心 片 中 后 层 电 路 的 生成 过 程 。 

DfT 先驱 采用 了 很 多 设计 技术 和 实践 应 用 ， 虽 在 实现 以 自动 化 方式 进行 的 有 效 测试 。 被 
先驱 们 称 作 “自动 检测 的 设备 ”只 不 过 是 一 组 特 设 软 件 程 序 的 集合 ， 用 来 测试 一 些 众 所 周知 
的 主板 功能 并 报告 结果 以 用 于 诊断 目的 。 

DfT 适应 了 软件 工程 ， 通 过 量 身 定制 的 程序 被 应 用 到 代码 的 测试 单元 上 来 。 最 终 ， 编 写 
单元 测试 就 像 是 编写 软件 。 当 你 编写 常规 代码 时 ， 通 第 叫做 类 和 函数 ， 你 关注 的 是 程序 的 总 
体 作用 和 实际 的 用 例 执行 。 相 反 ， 当 你 编写 单元 测试 时 ， 你 更 需要 关注 各 个 方法 和 类 的 输入 
输出 ， 这 是 一 个 不 同 的 粒度 级 别 。 

DfT 定义 了 任何 软件 单元 都 必须 易于 测试 的 三 个 特性 : 控制 性 、 可 见 性 和 简单 性 。 你 会 
惊讶 地 发 现 这 些 特性 解决 的 正 是 前 面 在 讨论 DfT 的 基础 时 所 描述 的 问题 。 
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1. 控制 性 的 特性 


控制 性 的 特性 指 的 是 代码 能 够 让 测试 人 员 将 固定 的 输入 数据 应 用 到 正在 测试 的 软件 中 
的 程度 。 任 何 一 款 软件 在 编写 时 都 应 该 明确 需要 哪些 参数 以 及 生成 什么 样 的 返回 值 。 另 外 ， 
任何 软件 都 应 该 抽象 其 依赖 性 一 参数 和 低层 模块 一 并 提供 外 部 调用 方 可 随意 注入 它们 的 
方式 。 

应 用 于 软件 的 控制 性 特性 ， 一 个 典型 示例 是 请 求 参数 的 方法 ， 而 不 是 利用 对 系统 的 了 解 
从 另 一 个 可 公开 访问 的 组 件 找 出 参数 的 值 。 在 DfT 中 ,控制 性 主要 是 关于 定义 一 个 用 于 软件 
组 件 的 虚拟 协议 , 该 组 件 中 包括 先决 条 件 。 配置 先决 条 件 越 容易 ， 就 越 容易 编写 有 效 的 测试 。 


2. 可 见 性 的 特性 


可 见 性 的 特性 被 定义 为 观察 软件 在 测试 状态 下 的 当前 状态 和 它 可 以 产生 输出 的 能 力 。 实 
现 了 在 方法 上 施加 特 设 的 输入 值 后 ， 下 一 步 就 是 验证 方法 是 否 如 预期 那样 表现 了 。 可 见 性 主 
要 是 关于 这 一 方面 一 在 方法 执行 之 后 要 验证 的 后 置 条 件 。 

与 可 见 性 有 关 的 主要 假设 是 ， 如 果 测试 人 员 能 够 以 编程 方式 观察 一 个 指定 的 行为 ， 就 能 
很 容易 地 测试 它 不 符合 预期 的 地 方 或 不 正确 的 值 。 后 置 条 件 是 将 软件 模块 的 预期 行为 形式 化 
的 一 种 方式 。 


3. 简单 性 的 特性 


简单 性 对 于 任何 系统 且 在 每 个 上 下 文中 都 是 积极 的 特性 。 显 然 测试 也 不 例外 。 简 单 且 极 
为 内 聚 的 组 件 是 最 适合 测 放 的 ， 因 为 你 需要 训 斌 的 越 少 ， 测 斌 过程 融 越 迅速 、 可 午 。 

归根 结 夺 ，DfT 是 编写 源 代 码 的 一 个 驱动 因素 ， 最 好 是 从 项 目 一 开始 编写 源 代 码 的 时 候 
就 开始 引入 ， 这 样 可 见 性 、 控 制 性 和 简单 性 的 特性 就 能 够 最 大 化 。 当 成 功 应 用 了 可 测试 性 的 
设计 时 ， 编 写 单 元 测试 总 体 上 会 变 得 简单 高 效 。 此 外 ， 你 的 代码 最 大 化 了 可 维护 性 ， 而 且 整 
体 上 更 匈 于 阅读 了 。 


注意 : 

许多 人 都 会 同意 ， 可 维护 性 是 软件 需要 专注 的 一 个 方面 ， 因 为 它 可 以 提供 长 效 的 好 处 。 
然而 ， 可 读 性 是 与 可 维护 性 严格 相关 的 ， 很 大 程度 上 ， 也 是 可 维护 性 要 努力 的 一 部 分 。 可 读 
性 是 指 编写 切 于 阅读 的 代码 ， 这 样 也 就 惫 于 理解 ， 在 更 新 和 改进 时 也 更 安全 。 可 读 性 要 通过 
全 公司 范围 的 命名 和 编码 约定 ， 并 且 更 好 的 是 ， 实 现 了 把 这 些 约定 有 效 地 传达 给 开发 团队 的 
方式 。 在 这 方面 ，Visual Studio Team Foundation Server 中 的 自 定 义 策略 能 提供 很 大 的 帮助 。 


9.1.2 松 黎 设计 
从 设计 的 角度 看 ， 可 测试 软件 本 质 上 是 更 好 的 软件 。 当 你 把 控制 性 、 可 见 性 和 简单 性 应 


305 


第 中 部 分 ASPNET MVC 软件 设计 


用 于 软件 开发 过 程 中 时 ， 最 终 会 获得 只 通过 约定 接口 就 能 进行 交互 的 相对 较 小 的 构建 块 。 编 
写 可 测试 软件 是 方便 其 他 人 以 编程 方式 使 用 它 。 可 测试 软件 的 典型 编程 用 户 是 测试 工具 一 一 
用 于 运行 单元 测试 的 程序 。 在 任何 时 候 ， 我 们 谈论 的 都 是 会 使 用 其 他 软件 的 软件 。 因 此 ， 低 
看 合 是 系统 应 用 的 普遍 原则 ， 遵 循 基于 接口 的 编程 是 创建 易于 测试 的 软件 的 最 好 做 法 。 

1. 基于 接口 的 编程 

紧 耦 合 使 软件 开发 变 得 更 加 简单 快速 。 紧 耦合 产生 于 明显 的 一 点 : 如 果 需 要 使 用 一 个 组 
件 ， 只 会 得 到 它 的 一 个 实例 。 这 会 产生 如 下 面 所 示 的 代码 : 


public class MyComponent 


{ 
private DefaultLogger logger; 
public MyComponent () 
{ 
logger = new DefaultLogger (); 
} 
public bool PerformTask() 
{ 
// Some work here 
bool success = true; 
i 
// Log activity 
lJogger.Log(...}; 
// Return success or fallure 
return success; 
} 
} 


MyComponent 类 完全 依赖 于 DefaultLogger。 你 不 能 在 没有 DefaultLogger 的 坏 韦 中 昔 用 
MyComponent 类 。 此 外 ， 你 不 能 在 阻止 DefaultLogger 正 弟 工作 的 运行 时 环境 中 重用 
MyComponent 类 。 这 是 类 之 间 紧 耦合 会 带 来 问题 的 一 个 例子 。 从 测试 的 角度 看 ， 不 重建 完全 
兼容 生产 环境 的 运行 时 环境 ， 就 不 能 测试 MyComponent 类 。 例 如 ， 如 果 DefaultLogger 登录 
到 微软 互联 网 信息 服务 (IS)， 你 的 测试 环境 就 必须 正确 配置 TS 并 使 其 正常 工作 。 

另 一 方面 ， 单 元 测试 的 好 处 是 你 能 够 快速 、 按 时 地 运行 测试 ， 专 注 于 软件 一 小 部 分 的 性 
能 表现 ， 忽 略 或 控制 依赖 性 。 如 果 打 算 将 类 编程 为 使 用 依赖 性 的 具体 实现 ， 明 显 就 不 可 能 做 
到 了 。 下 面 介绍 了 如 何 重 写 MyComponent 类 ， 使 它 依赖 于 接口 从 而 产生 更 多 的 可 维护 和 可 
测试 的 代码 。 
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public class MyComponent 
{ 
private ILogger logger; 
public MyComponent () 
{ 
logger = new DefaultLogger (1) 7 
} 
public MyComponent (ILogger logger) 
{ 
logger = logger; 
} 
public bool PerformTask () 
{ 
// Some work here 
bool success = true; 


// Log activity 
logger.Log(...}); 


// Return success or failure 
return success; 


} 

MyComponent 类 日 前 依赖 于 ILogger 接口 ， 该 接口 会 抽象 出 日 志 记 录 模 块 的 依赖 性 。 
MyComponent 类 现在 就 清楚 如 何 处 理 实现 ILogger 接口 的 任何 对 象 了 了 ， 包 括 你 可 能 以 编程 方 
式 注 入 的 对 象 。 

上 面 的 解决 方案 从 测试 的 角度 看 是 可 以 接受 的 ， 即 使 它 远 非 完美 。 在 前 面 的 实现 中 ， 
MyComponent 类 仍然 依赖 于 DefaultLogger， 且 在 没有 定义 DefaultLogger 的 程序 集 的 情况 下 
你 不 能 真正 地 重用 它 。 不 过 ， 至 少 可 以 绕 过 默认 的 日 志 记 录 器 用 它 单 独 测试 MyComponent 
类 的 性 能 ， 如 下 所 示 : 

// Arrange the call 


Var fakeLogger = new FakeLogger (); 
Var component = new MyComponent (fakeLogger); 


// Perform the call and check against expectations 
Assert (component .PerformTask () ); 


指示 你 的 类 面向 接口 运行 而 不 是 面向 实现 运行 是 现代 软件 开发 的 五 大 支柱 之 一 。 开 发 的 
五 项 原则 常常 被 总 结 为 首 字母 缩写 的 SOLID 一 词 ， 下 面 是 这 五 项 原则 首 字母 形式 的 含义 : 
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单一 职责 原则 
开 闭 原则 
里 氏 昔 换 原 则 
接口 隔离 原则 
依赖 反 转 原 则 

关于 五 项 原则 的 更 多 信息 ， 请 公 阅 由 我 和 Andrea Saltarello 合 闭 的 Microsoft .NET 
Architecting Applications for the Enterprise( 敌 软 出 版 社 ，2008 年 出 版 ) 一 书 。 

在 现代 软件 中 ， 编 写 面 问 接 口 而 非 面 问 实 现 的 代码 这 一 概念 已 被 广 为 接 受 和 应 用 了 ， 但 
它 也 常常 被 男 一 个 更 具体 的 概念 所 掩 新 : 依赖 注入 。 

我 们 可 以 说 基于 接口 编程 的 整个 概念 是 在 依赖 反 转 原则 (DIP) 中 进行 便 编 码 , 且 依 赖 注入 
是 应 用 DIP 的 一 种 流行 设计 模式 。 第 7 章 “ 设 计 ASPNET MVC 控制 器 的 注意 事项 ”中 讨论 
了 DIP 和 相关 的 模式 ， 如 依赖 注入 和 服务 定位 器 。 


2. 软件 可 测试 性 的 相对 性 


可 测 弃 性 的 设计 很 重要 是 因为 它 会 产生 易于 测 试 的 软件 吗 ? 或 者 说 ， 是 因为 它 会 产生 本 
质 上 具有 更 好 设计 的 软件 吗 ? 我 绝对 赞成 第 二 种 说 法 (即使 第 一 种 说 法 也 有 强 有 力 的 论据 )。 

你 不 可 能 同 客户 推介 可 测试 性 特点 来 销售 产品 。 你 大 概 会 专注 在 其 他 特征 的 推介 上 ， 比 
如 功能 、 整 体 品质 、 用 户 友 好 上 度 以 及 易 用 性 。 可 测试 性 主要 是 对 于 开发 人 员 很 重要 ， 因 为 这 
是 设计 和 编码 质量 的 上 晴雨 表 。 从 客 尸 的 角度 来 看 ， 也 许 “ 能 运行 的 可 测试 代码 ”和 “能 运行 
的 不 可 测试 代码 ”之 则 并 没有 什么 区 列 。 

另 一 方面 ， 一 亚 易 于 训 试 的 软件 一 定 是 松散 耦合 的 ， 它 会 提供 核心 部 件 之 间 的 关注 分 离 
(SoC)， 并 且 匈 于 维护 ， 因 为 它 有 一 系列 的 测试 能 及 时 承载 任何 回归 。 除 此 之 外 ， 它 的 结构 本 
号 也 更 人 简单， 能 很 好 地 适用 于 未 来 的 扩展 。 

归根 结 克 ， 妃 求 可 测试 性 是 希望 拥有 有 具有 展 好 设计 软件 的 一 个 理由 。 此 外 ， 一 旦 你 得 到 
它 ， 也 能 人 很 容 多 地 测试 它 ! 


注意 : 

我 说 过 ， 从 客户 的 角度 看 也 许 “能 运行 的 可 测试 代码 ”和 “能 运行 的 不 可 测 代 码 ” 之 间 
没有 区 别 。 好 吧 ， 两 者 之 间 是 否 有 差异 实际 上 取决 于 客户 。 如 果 客 尸 与 你 达成 的 是 一 个 长 期 
项 目 ， 他 可 能 会 对 代码 的 可 维护 性 很 感 兴 趣 。 在 这 种 情况 下 ， 代 码 是 否 具有 可 测试 性 就 会 产 
生 很 大 的 差别 。 但 要 再 次 说 明 的 是 ， 这 更 多 涉及 的 是 设计 方面 的 内 容 而 不 是 可 测试 方面 的 
内 容 。 
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3. 可 测试 性 与 耦合 


耦合 与 可 测试 性 之 间 有 着 密切 的 关系 。 不 能 在 测试 中 轻松 实例 化 的 类 肯定 有 某 些 严 重 的 
耦合 问题 。 这 并 不 是 说 你 不 能 对 其 自动 测试 ， 但 你 也 许 要 在 测试 环境 中 配置 一 些 数据 库 或 外 
部 连接 ， 这 就 必然 导致 测试 变 慢 ， 相 对 的 维护 成 本 也 会 增加 。 

有 效 的 测试 必须 快 ， 并 在 内 存 中 执行 。 一 个 有 良好 测试 覆盖 率 的 项 目 很 可 能 每 个 类 都 有 
几 个 简单 的 测试 ， 加 起 来 可 能 会 有 几 千 个 测试 调用 。 如 果 每 个 测试 都 足够 快 ， 且 没有 因 同 步 
和 连接 所 导致 的 延 时 ， 那 么 这 还 是 一 个 容易 管理 的 问题 。 和 否则， 问题 就 会 变 得 比较 严重 。 

如 果 组 件 之 间 的 耦合 问题 未 在 设计 中 妥善 解决 ， 那 么 你 最 终 还 要 测试 与 其 他 组 件 进行 交 
互 的 组 件 ， 这 看 起 来 就 更 像 是 一 个 集成 测试 而 非 单元 测试 了 。 集 成 测试 也 是 必要 的 ， 但 理想 
情况 下 它们 应 该 在 独立 的 代码 单元 (比如 类 ) 上 运行 ， 而 这 些 代码 单元 应 该 已 经 彻底 进行 过 隔 
离 测试 了 。 集 成 测试 不 像 单元 测试 进行 地 那么 频繁 ， 因 为 它们 速度 相对 较 慢 ， 设 置 成 本 也 
更 高 。 

另外 ， 如 果 最 终 选用 集成 测试 来 测试 一 个 类 且 出 现 了 失败 ， 那 么 如 何 才能 够 轻松 地 识别 
出 问题 所 在 呢 ? 它 是 发 生 在 你 要 测试 的 类 中 还 是 由 某 些 依赖 性 所 引发 的 呢 ? 找到 正确 的 问题 
会 变 得 更 加 耗 时 耗 力 。 甚 至 于 即便 你 找到 问题 ， 对 其 进行 修复 还 可 能 对 上 层 组 件 产生 不 利 影 
响 。 

要 在 设计 层面 保持 对 耦合 的 控制 (比如 系统 性 应 用 依赖 注入 )， 可 以 强制 执行 可 测试 性 。 
相反 ， 通 过 追求 可 测试 性 ， 保 持 了 对 耦合 的 控制 ， 最 终 就 能 拥有 一 个 对 软件 的 更 好 设计 。 


4. 可 测试 性 与 面向 对 象 


一 个 主要 争论 点 是 为 可 测试 性 牺牲 某 些 设计 原则 (特别 是 面 同 对 象 原则 ) 是 否 值 得 (如 果 
值得 ， 要 做 出 何 种 程度 的 牺牲 )。 如 前 所 述 ， 可 测试 性 是 奶 求 更 好 设计 的 驱动 力 ， 但 如 果 没 有 
单元 测试 ， 你 确实 也 可 以 有 一 个 伟大 的 设计 ， 同 时 有 一 个 几乎 不 可 能 自动 测试 的 伟大 软件 。 

这 里 的 要 点 略 有 不同。 如 果 追 求 面 回 对 象 的 优秀 设计 ， 可 能 会 有 一 个 策略 ， 将 虚拟 成 员 
和 继承 类 的 使 用 限制 到 只 在 绝对 必 楼 时 使 用 。 然 而 ， 非 虚 方 法 和 密封 类 很 难 测 试 ， 因 为 大 多 
数 的 测试 环境 都 需要 模拟 类 和 重 写成 员 。 还 有 ， 你 为 什么 要 有 一 个 除了 测试 别 无 他 用 的 额外 
构造 函数 呢 ? 你 又 应 该 做 什么 呢 ? 

显然 这 是 一 个 需要 考虑 和 权衡 的 问题 。 

晶 是 ， 你 要 考虑 到 了 商业 工具 的 存在 可 以 让 你 无 视 类 的 设计 ， 对 其 进行 模拟 和 测试 ， 包 括 
密封 类 和 非 虚 方 法 。 一 个 极 好 的 例子 是 Typemock (http://www.typemock.com)。 很 长 一 段 时 间 ， 
微软 都 有 一 个 称 为 Moles 的 框架 ， 它 包含 在 Visual Studio 2010 Power Tools (http://tinyurl.com/ 
b4zuqj) 中 。Moles 不 表 受 Visual Studio 2013 的 支持 ， 它 被 一 个 新 的 称 为 Fakes(http://bit.ly/ 
zenveW) 的 框 染 所 取代 J 。 
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在 我 们 终于 要 处 理 ASPNET MVC 中 的 测试 以 前 ， 先 简要 地 回顾 一 下 单元 测试 的 基本 知 
识 。 如 果 已 经 熟知 像 伪 造 、 模 拟 、 隔 离 测 试 这 样 的 概念 ， 则 可 以 直接 跳 到 9.3 节 。 


9.2 时 元 测试 的 基本 知识 


单元 测试 会 验证 单独 的 代码 单元 是 否 按照 它们 预期 的 作用 正常 运行 。 单 元 是 应 用 程序 可 
测试 的 最 小 部 分 一 一 通常 是 类 上 的 一 个 方法 。 

单元 测试 包括 编写 和 运行 一 个 小 的 程序 ( 称 作 之 前 提 到 的 测试 工具 )， 以 自动 的 方式 实例 
化 测试 类 以 及 调用 测试 方法 。 测 试 类 是 一 个 承载 测试 方法 的 容器 ， 而 测试 方法 是 通过 使 用 一 
组 特定 的 输入 值 从 而 调用 方法 进行 测试 的 一 个 帮助 器 方法 。 归 根 结 确 ， 运 行 一 系列 的 测试 很 
像 是 在 编译 (参见 图 9-1)。 在 选择 的 编程 环境 (例如 Visual Studio) 中 单 击 一 个 按钮 ， 运 行 测试 
工具 ， 在 运行 结束 时 ， 如 果 有 错误， 就 会 知道 出 了 什么 错 。 


:| -| 全 | DinoE@EXPOWARE 2013-03-311( ~|| 池 Run” 扣 Debug- 趾 避 | 且 起" 名 | 
I Testrun completed Results: 9/9 passed: ltemls) checked:0 
Result Test Name Project Error Message 

中 本 曾 passed Index 5ampleApp,Tests 
口上 部 passed About SampleApp.Tests 
6 引 @ passed Output SampleApp.Tests 
6 下部 Passed Should Write To Session State SampleApp,Tests 
Should Read From ession State SampleApp.Tests 


Test Method Wrth_ Filters SampleApp.Tests 
Test H_Ur| Extensions Work SampleApp. Tests 
Test Hf Dates Are Processed SampleApp.Tests 
Test Hi Routes Work SampleApp.Tests 


图 9-1 在 Visual Studio 中 运行 测试 项 目 
9.2.1 使 用 测试 工具 


测试 工具 的 最 简单 形式 是 一 个 手工 编写 的 程序 ， 它 会 从 一 些 外 部 文件 中 读 取 测试 用 例 的 
输入 值 和 相应 的 预期 结果 。 然 后 测试 工具 通过 使 用 输入 值 来 调用 方法 ， 并 将 结果 与 预期 值 进 
行 比较 。 很 明显 ， 完 全 从 头 开始 编写 此 类 测试 工具 ， 至 少 是 耗 时 且 容 易 出 错 的 。 更 重要 的 是 ， 
它 在 可 以 利用 的 测试 功能 方面 是 受 限制 的 。 

执行 单元 测试 的 最 有 效 和 最 第 见 的 方式 是 使 用 一 种 目 动 化 的 测试 框架 。 目 动 化 的 测 试 框 
架 是 一 个 开发 人 员工 具 ， 通 常 包 括 一 个 运行 时 引擎 和 一 个 类 的 框架 ， 用 于 简化 测试 程序 的 
创建 。 
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1. 选择 一 个 测试 环境 


常用 的 测试 工具 是 MSTest、NUnit 及 其 继任 者 xUnitnet。MSTest 是 集成 在 Visual Studio 
所 有 版 本 中 的 测试 工具 。 图 9-1 展示 了 Visual Studio 中 MSTest 的 用 户 界 面 。 

NUnit( 可 以 在 http://www.nunit.org 找到 ) 是 - - 款 开源 产品 ， 己 经 面世 好 几 年 。NUnit 被 设 
计 为 一 个 独立 的 工具 ， 并 不 以 本 地 方式 与 Visual Studio 集成 ， 这 可 以 是 好 消息 也 可 以 是 坏 消 
息 ， 取 决 于 你 看 待 它 的 角度 以 及 你 的 需求 和 期 望 。 不 过 ，Visual Studio Gallery 中 有 一 个 集成 
包 ， 以 便 在 Visual Studio 内 部 使 用 NUnit。 

xUnitnet( 更 多 相关 内 容 可 以 在 http://xunit.codeplex.com 中 找到 ) 是 用 于 单元 测试 NET 项 
目的 最 新 框架 。 如 图 9-2 所 示 ， 它 配备 了 一 个 安装 程序 ， 用 这 个 安装 程序 ， 可 以 将 xUnit.net 
作为 一 个 新 的 测试 框架 添加 到 创建 新 ASPNET MVC 应 用 程序 的 默认 向 导 中 。 


局 | Create a unit test project 
Test project name: 
MycApplicationl,.Tests 


Test frarmeworke 


Addrtional Info 


Visual Studio Unit Test 
xlinit.net build 1 .8.0.1545 


图 9-2 选取 你 喜欢 的 测试 框架 


最 终 ， 测 试 框架 的 选择 还 真 的 是 见仁见智 的 问题 。 无 论 选 择 哪 一 个 ， 客 观 上 你 几乎 都 不 
会 失去 什么 真正 重要 的 东西 。 但 测试 问题 远 不 止 所 使 用 的 框架 那么 简单 。 在 我 看 来 ，MSTest 
和 NUnit 之 间 没 有 太 大 的 技术 差别 。 那 么 XUnitnet 呢 ? 如 前 所 述 ，xUnitnet 是 最 新 的 测试 工 
具 , 它 由 NUnit 的 创始 人 James Newkirk 所 创建 ,基于 这 些 原因 ,xUnit.net 很 可 能 吸收 了 NUnit 
多 年 的 经 验 和 反 饿 ， 你 也 许 会 发 现 它 更 接近 于 你 心目 中 的 理想 工具 。 

总 体 而 言 , 测试 框架 在 功能 方面 具有 相似 性 并 不 意味 看 你 就 不 能 对 它们 有 所 偏好 。 然而 ， 
无 论 选择 的 理由 是 什么 ， 它 更 多 涉及 的 是 个 人 喜好 而 非 工 具 本 身 功能 上 的 差异 。 这 本 书 中 我 
使 用 的 是 MSTest， 但 我 会 简要 指出 与 其 他 工具 的 差别 ， 尤 其 是 与 xUnitnet 的 差别 。 


2. 测试 固件 


测试 是 从 在 测试 固件 中 对 相关 测试 进行 分 组 开始 的 。 测 试 固件 是 特定 于 测试 的 类 ， 其 中 
的 方法 通常 代表 了 要 运行 的 测试 。 在 测试 固件 中 ， 你 可 能 还 有 在 测试 伊始 和 测试 运行 结束 时 
执行 的 代码 。 下 面 是 MSTest 测试 固件 的 主要 结构 : 


uSing Microsoft.Visualstudio.TestTools.UnitTesting; 


[TestClassl| 
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public class CustomerTestCase 
{ 


private Customer customer; 


[TestInitiallizel] 
public void SetUp () 
{ 
cuStomer = new Customer () : 


} 


[TestcCleanupl 
public vold TearDown () 


{ 
customer = null:; 


} 


// Your tests go here 

[TestMethod | 

public vold ShouldComplainInCaseOofInvalidId() 
{ 


} 
} 


测试 固件 是 在 一 个 特 设 的 Visual Studio 项 目 中 分 组 的 。 当 你 新 创建 了 一 个 ASPNET MVC 
项 目 时 ，Visual Studio 即 为 你 提供 一 个 新 创建 的 测试 项 目 。 

通过 简单 地 添加 TestClass 特性 就 可 以 把 一 个 普通 的 .NET 类 转变 成 一 个 测试 固件 。 而 通 
过 使 用 TestMethod 特性 可 以 把 .NET 类 的 方法 转变 成 测试 方法 。TestInitialize 和 TestCleanup 
这 样 的 类 具有 特殊 含义 ,分 别 表 示 .NET 类 中 需要 在 每 个 测试 之 前 与 之 后 运行 的 代码 。 而 通过 
使 用 像 ClassInitialize 和 ClassCleanup 这 样 的 特性 , 你 就 可 以 定义 某 个 类 中 在 每 个 测试 之 前 和 
之 后 只 运行 一 识 的 代码 。 


注意 : 

关于 测试 类 (或 固件 )， 在 xUnit.net 和 其 他 工具 之 间 存 在 一 些 差异 。 在 xUnit.net 中 ,你 不 
需要 用 特殊 的 特性 来 修饰 测试 类 。 该 框架 会 在 所 有 可 用 的 公共 类 中 寻找 所 有 的 测试 方法 。 就 
初始 化 和 清理 代码 而 言 ，xUnit.net 要 求 你 将 类 构造 函数 和 Dispose 方法 用 于 每 个 测试 的 任何 
操作 。 在 你 的 测试 类 中 要 一 次 性 实现 IUseFixture， 还 要 实现 类 级 别 的 初始 化 和 拆 纯 。 
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3. 设置 、 人 作用、 断言 


测试 方法 的 典型 设计 可 总 结 为 三 个 缩写 的 “A”， 分 别 代表 着 设置 、 作 用 、 断 言 。 首 先 要 
nearertt gtr 

接着 ， 要 将 作用 于 该 类 的 代码 置 于 测试 状态 ， ER ， 处 理 结果 
并 验证 接收 的 输出 是 否 正确 。 这 一 步 是 通过 根据 你 的 预期 进行 oie 

A 可 
以 检查 结果 是 否 符合 预期 值 。 


[TestMethodi 
public void AssignPropertyId() 


{ 


} 


// Define the input data for the test 
Var customer = new CUStomer () ， 

strindg 1d = ”IDS”， 

string expected = 1d; 


// Execute the action to test. 
customer.ID = 1d; 


// Test the results 
Assert .AreEqual (expected, customer .ID); 


测试 并 不 一 定 要 检查 结 吉 果 是 否 正 确 。 一 个 有 效 的 测试 也 旨 在 验证 在 一 定 条 件 下 某 种 方法 


国 
是 人 否 会 


引发 异常 。 下 面 是 一 个 示例 ， 如 果 分 配 了 空 字 符 串 ，Customer 类 中 ID 属性 的 设置 器 


就 会 引 发 AreumentException 寞 第 : 


[TestMethodi 
[ExpectedException (typeof (ArgumentExcept1ion))] 
Public void AssignPropertyId() 


{ 


} 


// Define the input data for the test 
Var customer = new Customer () ， 
Var lid = String.Empty; 


// Execute the action to test. 
customer.ID = 1id: 


编写 测试 时 ， 可 以 决定 暂时 忽略 掉 某 个 部 分 ， 因 为 你 知道 它 不 能 正常 运行 ， 只 是 目前 没 
有 时 间 去 修复 。 这 种 情况 就 可 以 使 用 如 下 所 示 的 Ignore 特性 : 


313 


第 中 部 分 ASPNET MVC 软件 设计 


[Ignorel 

[TestMethodi 

Public vold AssignPropertyId() 
{ 


} 

同样 ， 可 以 决定 将 测试 标记 为 暂时 不 确定 ， 因 为 你 目前 无 法 确定 在 哪些 条 件 下 测试 会 成 
功 或 者 失败 。 

[TestMethodl] 


public void AssignPropertyId() 
{ 


Assert.Inconclusive ("Unable to determine success or fallure™); 

} 

你 也 许 会 认为 忽略 挥 一 个 测试 或 将 其 标记 为 不 确定 是 多 余 的 任务 ， 因 为 可 以 直接 将 出 于 
某 些 原因 不 能 工作 的 测试 给 注释 抒 。 这 当然 是 可 行 的 ， 但 经 验 告 诉 我 们 测试 是 一 项 脆弱 的 任 
务 ， 总 是 会 在 正常 优先 级 和 低 优 先 级 的 界限 之 间 摆 动 。 此 外 ， 当 它 被 注释 掉 以 后 会 很 容易 被 
遗忘 。 所 有 的 测试 框架 都 提供 了 在 保持 代码 活跃 于 项 目的 同时 以 编程 方式 忽略 测试 ， 这 并 不 
是 侦 然 的 。 测 试 工具 的 作者 知道 项 目 进 度 和 预算 通常 都 很 紧 ， 但 是 他 们 也 知道 将 测试 维持 在 
可 执行 状态 也 很 重要 。 任 何 时 候 运 行 测 试 ， 你 都 会 想起 一 些 测试 被 忽略 了 或 者 是 不 确定 的 。 
忆 体 来 看 ， 这 优 于 仪 仅 把 测试 注释 挥 (同时 也 容易 遗 态 挥 )。 


注意 : 

xUnit.net 用 一 个 新 的 Assert 上 的 方法 一 一 Assert.Throws 方法 一 一 替换 了 ExpectedException 
特性 。Ignore 被 Fact 特性 (等 同 于 TestMethod 特性 ) 上 的 Skip 参数 所 取代 。 最 后 ， 
Assert.Inconclusive 在 xUnit.net 中 已 不 受 支 持 了 。 要 获知 更 多 有 关 xUnit.net 和 其 他 框架 之 间 
差别 的 信息 ， 请 参见 http://xunit.codeplex.com/wikipage?title=Comparisons&referringTitle=Home. 

4. 数据 驱动 的 测试 

当 你 为 某 个 类 方法 安排 一 次 测试 时 ， 有 时 可 能 需要 尝试 多 个 可 能 的 值 ， 包 括 正确 的 和 不 
正确 的 值 ， 以 及 表示 边界 条 件 的 值 。 在 这 种 情况 下 ， 数 据 驱 动 的 测试 是 大 有 助 益 的 。 

MSTest 支持 两 个 可 能 的 数据 源 : 微软 O 人 ce Excel 的 .csv 文件 和 任何 有 效 的 ADO.NET 
数据 源 。 测 试 必须 通过 使 用 DataSource 特性 绑 定 到 数据 源 ， 并 运行 一 个 测试 实例 用 于 数据 源 
中 的 每 个 值 。 数 据 源 会 包含 输入 值 和 预期 值 。 
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var 1d = TestContext .DataRow["ID"] .ToString (); 
Var expected = TestContext .DataRow["Result"] .Tostring (); 


Assert.AreEqual (id, expected); 


TestContext 变量 用 于 读 取 输入 的 值 。 在 MSTest 中 ， 当 你 添加 一 个 新 的 单元 测试 时 ， 
TestContext 变量 会 自动 定义 : 
private TestContext testContextInstance; 
public TestContext TestContext 
{ 
get { return testContextInstance; } 
set { testContextInstance = value; } 
} 
尤其 是 ，DataSource 特性 还 允许 你 指定 测试 输入 值 的 顺序 ,是 随机 处 理 还 是 按 顺 序 处 理 。 
9.2.2 测试 的 特性 
编写 单元 测试 仍然 是 一 种 编程 , 与 生产 代码 的 软件 编程 一 样 , 也 需要 民 好 的 实践 和 技术 。 
但 是 单元 测试 的 编写 还 有 其 自己 的 一 组 模式 和 特点 ， 你 必须 要 了 解 。 


1. 非常 有 限 的 范围 


在 本 章 开 头 介 绍 DfT 的 时 候 , 我 就 特意 提出 了 以 下 观点 : 简单 性 是 软件 的 一 个 基本 方面 ， 
征 司 用 可 测试 性 的 关键 。 当 应 用 到 单元 测试 时 ,简单 性 融 水 及 测试 指定 的 有 限 范 围 内 的 代码 。 

有 限 的 范围 使 测试 不 言 自明 并 清楚 地 揭示 了 其 目的 。 人 至 少 有 两 个 原因 说 明 这 样 做 是 有 益 
的 。 第 一 ， 任 何 检查 该 测试 的 开发 人 员 ， 包 括 几 星期 之 后 再 回来 检查 的 原 编写 者 ， 都 可 以 快 
速 、 明 确 地 理解 被 测试 方法 的 预期 行为 。 

第 二 , 一 个 失败 的 测试 会 带 来 额外 的 拉 烦 , 你 需要 找 出 失败 的 原因 以 便 修复 被 测试 的 类 。 
测试 方法 越 简单 ， 就 越 容 易 在 被 测试 的 关中 将 问题 隅 离 出 来 。 此 外 ， 被 测试 类 的 分 层 越 多 ， 
就 越 容易 应 用 更 改 而 没有 破坏 别处 代码 的 风险 。 最 后 ， 编 写 小 范围 的 测试 对 于 将 依赖 性 控制 
在 其 他 组 件 的 类 来 说 更 为 容易 。 

时 元 测试 束 像 一 个 团 环 :; 它 是 民 性 还 是 恶性 完全 取 雇 于 你 , 而 且 主 要 取决 于 设计 的 质量 。 


2. 隔离 测试 


与 小 艺 围 单元 测试 紧密 相关 的 一 个 方面 是 测试 隔离 。 在 测试 一 个 方法 时 ， 你 会 希望 将 注 
意 力 放 在 该 方法 中 的 代码 上 。 你 需要 知道 的 只 是 该 代码 在 测试 场景 中 是 否 提供 了 预期 的 结果 。 
要 获知 这 个 信息 ， 束 需要 控 脱 该 方法 可 能 有 的 所 有 依赖 性 。 

例如 ,如果 该 方法 调用 男 一 个 类 ,你 就 要 假定 被 调用 的 类 始终 会 返回 正确 的 结果 。 这 样 ， 
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你 就 从 根源 上 消除 了 该 方 法 测试 失败 的 风险 ， 因 为 失败 是 沿 着 调用 堆栈 发 生 的 。 如 果 测 试 A 
方法 失败 了 ， 就 可 以 特定 在 A 方法 的 源 代码 中 找 原 因而 不 是 在 A 方法 的 任何 依赖 性 中 找 。 

强烈 建议 你 把 正在 测试 的 类 从 其 依赖 性 中 隔离 开 来 。 但 是 要 注意 ， 这 只 在 此 类 是 以 松散 
耦合 的 方式 设计 的 情况 下 可 行 。 在 面 回 对 象 的 场景 中 ， 当 验证 了 下 面 任 何 一 个 条 件 时 ，A 类 
都 依赖 于 B 类 : 

e A 类 派生 于 B 类 。 

e A 类 包含 B 类 的 成 员 

e A 类 的 方法 之 一 调用 了 B 类 的 方法 

e A 类 的 方法 之 一 接收 或 返回 B 类 的 参数 

e A 类 依赖 于 一 个 类 ， 这 个 类 又 依赖 于 了 类 。 

如 何在 测试 一 个 方法 时 消除 依赖 性 呢 ? 请 使 用 测试 蔡 丑 。 


3. 伪造 和 模拟 


测试 蔡 身 (test double) 是 用 来 代替 另 一 个 对 象 的 对 象 。 测 试 蔡 身 用 来 假装 成 指定 场景 真正 
期 望 的 那个 对 象 .使 用 一 个 实现 ILogger 接口 的 对 象 的 类 可 以 接受 真正 的 记录 到 IIS 或 某 些 数 
据 库 表 的 记录 器 对 象 。 同 时 ， 它 还 可 以 接受 一 个 假装 是 记录 器 但 不 执行 任何 操作 的 对 象 。 有 
两 种 主要 类 型 的 测试 蔡 身 ,伪造 和 模拟 。 

最 简单 的 选择 是 使 用 伪造 对 象 。 伪 造 对 象 是 一 个 对 象 的 相对 简单 的 克隆 ， 它 提供 与 原始 
对 象 相同 的 接口 ， 但 返回 硬 编码 或 以 编程 方式 确定 的 值 。 下 面 是 一 个 ILogger 类 型 的 伪造 对 
象 示例 : 


Publlc class FakeLogger : ILogger 


{ 
public vold Log (String message) 
{ 
return; 
} 
} 


可 以 看 出 ， 伪 造 对 象 的 行为 是 便 编码 的 ， 伪 造 对 象 不 具有 状态 和 明显 的 行为 。 从 伪造 对 
象 的 角度 来 看 ， 你 调用 一 个 伪造 方法 的 次 数 以 及 该 调用 发 生 在 流 中 的 时 间 都 没有 区 别 。 在 想 
要 忽略 依赖 性 的 时 候 就 可 以 使 用 伪造 方法 。 

一 个 更 复杂 的 选项 是 使 用 模拟 对 象 。 伪 造 对 象 能 完成 的 任务 模拟 对 象 都 能 完成 ， 但 模拟 
对 象 还 能 完成 更 多 的 任务 。 在 某 种 程度 上 ， 一 个 模拟 就 是 具有 它 自 己 特性 的 对 象 ， 这 些 特 性 
需要 模拟 男 一 个 对 象 的 行为 和 接口 。 

一 个 模拟 还 能 向 测试 人 员 提 供 什么 呢 ?” 基 本 上 ， 模 拟 可 适应 对 方法 调用 上 下 文 的 验证 。 
借助 模拟 ， 你 就 可 以 验证 方法 调用 是 否 是 在 合适 的 前 提 条 件 下 、 以 该 类 中 与 其 他 方法 有 关 的 
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正确 顺序 及 生 的 。 
手动 编 与 一 个 伪造 通 贡 不 是 什么 大 问题 ; 大 多 数 情 况 下 ， 你 需要 的 所 有 逻辑 都 简单 且 不 
需 频 繁 更 改 。 当 你 使 用 伪造 时 ， 主 要 关注 的 是 伪造 对 象 可 能 代表 的 状态 ; 而 个 是 想 与 它 交 互 。 
相反 ， 当 你 需要 在 测试 过 程 中 与 依赖 对 象 进行 交互 时 要 使 用 模拟 对 象 。 例 如 ， 你 也 许 想 知道 
模拟 对 象 是 耕 被 调用 ， 并 且 可 能 要 决定 测试 中 对 于 指定 方法 必须 返回 什么 样 的 模拟 对 象 。 
手动 编写 模拟 当然 是 可 行 的 ， 但 它 很 少 成 为 你 会 考虑 的 选项 。 从 你 期 望 从 一 个 模拟 中 获 
得 的 灵活 性 程度 考虑 ， 你 需要 的 是 一 个 特 设 的 模拟 框架 。 表 9-1 列 出 了 几 个 流行 的 模拟 框架 。 


表 9-1 一 些 流行 的 模拟 框 染 


产 品 URL 
Moq http://code.google.com/p/moq 
NIMock2 http://sourceftorge.net/prolects/nmock2 
Typemock http://www.typemock.com 
Rhino Mocks http://hibernatingrhinos.com/open-source/rhino-mocks 


注意 ， 目 前 没有 模拟 框架 被 集成 在 Visual Studio 及 其 早期 的 版 本 中 。 

除了 Typemock 是 个 明显 的 例外 , 表 中 的 其 他 框架 都 是 开源 软件 。Typemock 是 具有 独特 
功能 的 商业 产品 ， 基 本 上 不 需要 为 可 测试 性 (重新 ) 设 计 你 的 代码 。 使 用 Typemock， 可 以 测试 
之 前 和 梓 认为 是 不 可 测试 的 方法 ， 如 静态 方法 、 非 虚拟 方法 和 裔 态 藉 。 

下 面 是 如 何 使 用 像 Moq 这 样 的 模拟 框 染 的 一 个 快速 示例 : 

[TestMethodi 


public void Test If Method Works () 
{ 
// Arrange 
Var logger = new Mock<ILogger> (); 
1ogger .Setup (1 => 1.Log(It.IsAny<string>())) 
var controller = new HomeController (logger); 


/:/ Act 


/:/ Assert 


} 
被 测试 的 类 (HomeController 类 ) 在 实现 ILogger 接口 的 对 象 上 有 一 个 依赖 性 : 


public interface ILogger 
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{ 
vold Log (String msg); 

} 

mock 存储 库 提 供 了 一 个 动态 创建 的 对 象 , 它 会 模拟 出 测试 将 会 使 用 的 接口 。 模拟 对 象 实 
现 Log 方 法 的 方式 是 不 对 该 方法 接收 到 的 任何 字符 串 参 数 做 处 理 。 你 并 不 真 的 在 测试 记录 器 ; 
而 是 专注 于 控制 器 类 ， 为 控制 器 内 部 所 使 用 的 记录 器 组 件 提 供 快 速 实用 的 模拟 。 

你 没有 必要 创建 一 个 完整 的 伪造 类 ;只 需要 指定 在 调用 时 给 定 方法 运行 所 需 的 代码 。 这 
就 是 模拟 相对 于 伪造 的 能 力 。 


4. 每 个 测试 中 断言 的 数量 


每 个 测试 应 该 有 多 少 断 言 呢 ? 为 了 遵循 小 范围 测试 的 准则 ， 你 就 必须 强制 把 每 个 测试 限 
定 为 一 个 断言 吗 ? 这 是 一 个 有 和 争议 的 地 方 。 

业界 不 少 人 似乎 都 认为 应 该 如 此 。 事 实 上 ， 文 持 这 一 观点 的 论据 也 相当 好 。 每 个 测试 一 
个 断言 会 引 寻 你 编写 更 专注 的 测试 ， 并 保持 你 的 限定 范围 。 每 个 测试 一 个 断言 会 使 每 个 测试 
的 测试 目的 一 目 了 然 。 

多 个 断言 的 需求 常常 会 掩 六 你 在 单个 测试 中 测试 很 多 功能 的 事实 。 这 显然 是 要 避免 的 事 
情 。 如 果 只 能 选择 一 个 原则 去 遵循 ， 每 个 测试 一 个 断言 的 原则 可 能 是 最 好 的 。 如 果 在 指定 操 
作 后 测试 菜 个 对 象 的 状态 ， 则 可 能 需要 检查 多 个 值 ， 并 需要 多 个 断言 。 你 当然 也 可 以 通过 一 
连 串 的 测试 来 表示 这 些 内 容 ， 每 个 测试 有 一 个 断言 。 但 是 在 我 看 来 ， 那 需要 大 量 的 重 构 ， 而 
获 丰 个 多 。 

我 不 介意 在 一 个 测试 中 有 多 个 断言 ， 只 要 测试 中 的 代码 测试 的 是 非常 特 定 的 性 能 。 大 多 
数 框架 都 会 止 于 第 一 个 失败 的 断言 处 ， 所 以 从 理论 上 讲 你 的 风险 是 ， 同 一 个 测试 中 的 其 他 断 
言 在 下 一 次 运行 时 也 可 能 会 失败 。 如 果 坚 守 原 则 只 测试 一 种 行为 ， 并 使 用 多 个 断言 来 验证 与 
该 行为 相关 的 类 的 多 个 方面 ， 那 么 所 有 的 断言 就 都 是 相关 的 ， 并 且 如 果 第 一 个 失败 ， 通 过 修 
复 它 有 很 大 可 能 你 不 会 在 该 测 试 中 得 到 更 多 的 失败 。 


5. 测试 内 部 成 员 


在 某 些 情况 下 ， 受 保护 的 方法 或 属性 需要 在 测试 中 访问 。 一 般 而 言 ， 类 成 员 不 一 定 要 公 
开 才 能 得 到 测试 。 但 是 ， 测 试 非 公共 成 员 却 会 带 来 别 的 问题 。 

测试 非 公 共 成 员 的 常用 方式 是 创建 一 个 扩展 所 测试 类 的 新 类 。 然 后 派生 的 类 要 添加 一 个 
公共 方法 来 调用 受 保护 的 方法 。 添 加 这 个 类 只 是 用 于 测试 项 目 ， 并 不 会 破坏 类 的 设计 。 

正如 前 面 提 到 的 , .NET 框架 中 更 好 的 方式 是 添加 一 个 所 测试 的 类 的 部 分 类 。 但 是 要 实现 
这 一 日 标 ， 原 始 类 自己 也 需要 被 标记 为 部 分 。 不 过 ， 从 设计 方面 来 看 ， 这 不 是 什么 大 问题 。 

在 .NET 中 , 也 可 以 轻易 地 通过 使 用 InternalsVisibleTo 特性 ,使 一 个 类 的 内 部 成 员 可 见于 
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为 一 个 程序 集 ( 比 如 测试 程序 集 )， 如 下 所 示 : 
[assembly: InternalsVisibleTo ("MyTests")] 


可 以 将 上 面 的 这 行 代 人 码 添加 到 项 目的 assemblyinfo.cs 文件 中 ， 访 项 目 包含 了 市 有 内 部 成 
员 的 那个 类 ， 这 样 就 能 使 其 可 用 了。 请 注意 可 以 多 次 使 用 这 个 特性 ， 以 便 让 类 的 内 部 成 员 对 
多 个 外 部 可 执行 程序 可 见 。 

依 我 之 见 ， 使 用 此 特性 比 使 用 部 分 类 要 更 冒失 一 些 。 事 实 上 ， 要 利用 该 特性 ， 必 须 将 你 
希望 从 测试 中 收回 的 任何 成 员 标记 为 内 部 成 员 。 内 部 成 员 仍然 没有 被 公开 可 用 ， 但 它们 的 可 
见 级 别 已 经 比 非 公 开 或 受 保护 要 高 了 。 换 句 话 说 ， 你 应 该 尽量 少 使 用 内 部 成 员 和 
InternalsToVisible， 并 且 仪 在 有 有 具体 需要 时 才 使 用 。 

最 后 ，MSTest 还 有 一 个 不 错 的 编程 功能 
非 公共 成 员 的 功能 。 


类 一 一 它 提 供 了 通过 反射 调用 


Var resourceld = "WelcomeMessage"; 


Var resourceFile = "MyRes.1it.resx"; 


下 
开 

var expected = ™...™ 
有 


Var po = new PrivateObject (controller); 


Var text = po.Invoke ("GetLocalizedText", new object[] { resourceId ， 
resourceFlile })，; 
Assert.AreEqual (text, expected) : 
你 要 将 包含 隐藏 成 员 的 对 象 封 装 在 PrivateObject 类 的 一 个 新 实例 中 。 接 着 ,要 调用 Invoke 
方法 以 间接 调用 带 有 作为 参数 列表 的 对 象 数组 的 那个 方法 。Invoke 方法 会 返回 一 个 表示 私有 
成 员 返 回 值 的 对 象 。 


6. 代码 敌 兰 率 


单元 测试 和 集成 测试 的 主要 目的 是 使 开发 团队 对 他 们 生产 的 软件 质量 有 信心 。 基 本 上 ， 
单元 测试 能 够 告知 开发 团队 他 们 做 得 好 不 好 ， 是 否 在 正确 的 轨道 上 上。 但是， 单元 测试 结果 的 
可 靠 性 到 底 有 多 高 呢 ? 

对 于 可 靠 性 的 衡量 在 茶 种 程度 上 还 取决 于 单元 测试 的 数量 和 测试 所 履 盖 的 代码 比例 。 换 
名 话说， 并 不 能 证 明代 码 上 履 善 率 与 软件 质量 之 间 存 在 着实 际 的 相关 性 。 

通 沿 情况 下 ， 蛙 元 测试 只 会 覆 新 代码 库 的 一 个 子 集 ， 对 于 代码 改 亲 比例 达到 多 少 算 好 并 
没有 一 个 统一 的 定论 。 有 人 说 80% 比 较 好 ;有些 人 其 至 不 愿 给 出 具体 数字 。 可 以 肯定 的 是 ， 
完全 的 代码 宪 新 率 实 际 上 是 无 法 实现 的 ， 即使 理论 上 有 这 种 可 能 。 

所 有 版 本 的 Visual Studio 都 有 代码 者 新 率 工 具 。 

另外， 代码 履 新 率 是 很 通用 的 术语 ， 可 以 涉及 很 多 不 同 的 计算 条 件 ， 如 函数 、 语 句 、 判 
定 和 路 竹 窗 新 。 郧 数 窗 新 测量 的 是 项 目 中 的 每 个 函数 是 耕 都 已 经 在 测试 中 得 到 了 执行 。 语 句 
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履 关 更 细致 地 痢 眼 于 源 代 码 的 独立 行 。 判 定 履 关 测 量 的 是 分 文 (如 站 语句 ) 是 否 被 评测 ， 而 路 
径 上 覆 希 会 检查 是 合 执行 了 每 一 个 通过 指定 代码 部 分 的 可 能 路 径 。 

每 个 标准 都 提供 了 一 个 看 竺 代码 的 视角 ， 但 返回 的 仅仅 是 待 说 明 的 数字 。 因 此 ， 测 试 所 
有 的 代码 行 ( 即 100% 的 语句 履 闹 率 ) 看 起 来 是 一 件 很 棒 的 事情 ; 然而 具有 更 高 值 的 路 径 覆 访 
率 也 许 更 可 取 。 代 码 窗 新 率 当 然 很 有 用 ， 因 为 它 可 以 帮助 你 识别 哪些 代码 还 没有 被 测试 。 然 
而 ， 代 码 履 闵 率 并 不 会 使 你 获知 很 多 与 测试 对 代码 的 执行 情况 有 关 的 信息 。 举 一 个 能 很 好 说 
明 这 一 情况 的 例 于 吧 。 

想象 一 个 处 理 整数 的 方法 。 可 以 对 它 进 行 100% 的 语句 履 盖 ， 但 如 果 缺 少 了 一 个 该 方法 
接收 了 超出 范围 的 无 效 值 的 测试 ， 则 可 能 在 运行 时 会 出 现 异 第 ， 尽 管 你 已 运行 了 前 面 所 有 成 
功 的 测试 。 

归根 结 确 ， 代 码 履 蓄 率 是 一 个 有 关 特 殊 测量 的 数字 问题 。 测 试 的 关联 性 是 真正 重要 的 事 
情 。 育 目地 增加 代码 履 凋 率 ， 或 更 糟 的 是 ， 要 求 开 友人 员 达 到 指定 的 履 凋 率 国 值 并 不 能 保证 
任何 事情 。 这 比 没 有 测试 可 能 还 是 要 好 一 些 ， 但 它 并 不 能 说 明 测 试 的 相关 性 和 有 效 性 。 专 注 
于 预期 的 行为 和 预期 的 输入 是 达成 测试 目标 的 最 合理 方式 。 一 个 经 过 民 好 测试 的 应 用 程序 就 
是 对 相关 应 用 场景 具有 高 履 闹 率 的 应 用 程序 。 


注意 : 

微软 用 于 Visual Studio 的 Pex 播 件 旨 在 理解 你 的 代码 还 辑 并 为 你 建议 需要 进行 的 相关 测 
试 。 在 内 部 ，Pex 采用 了 静 态 分 析 技 术 ， 以 构建 有 关 你 的 应 用 程序 行为 的 知识 基础 。 可 以 从 
http://tinyurl.com/b4zuqj 处 下 载 Pex。 


9.3 测试 ASP.NET MVC 代码 


可 测试 性 常常 被 看 作 是 使 ASPNET MVC 成 为 微软 平台 Web 开发 的 首要 考虑 选项 的 一 
个 不 可 分 割 的 功能 。 由 于 ASPNET MVC 有 视图 和 行为 之 间 的 SoC， 所 以 确实 有 助 于 开发 人 
员 编 写 更 为 健壮 和 精心 设计 的 软件 。ASPNET MVC 运行 时 还 提供 了 一 个 API， 它 会 抽象 出 
你 的 代码 在 ASPNET 内 部 对 象 上 可 能 有 的 任何 依赖 性 。 就 测试 而 言 , 这 种 改变 标志 着 与 Web 
Forms 的 巨大 区 别 。 最 起 码 ，ASPNET MVC 绝对 是 一 个 便于 单元 测试 的 框架 。 
9.3.1 应 该 测试 哪 部 分 代码 

如 前 所 述 , ASPNET MVC 提供 了 应 用 程序 的 支柱 一 一 控制 占 、 视图 和 模型 之 间 的 有 了 友 分 
离 。 此 外 ， 它 减少 了 你 的 代码 对 ASPNET 运行 时 内 部 组 件 的 依赖 ， 比 如 Request、Response 
和 Session。 模板 项 目 还 提供 了 一 个 global.asax 文件 ， 其 中 所 有 的 初始 化 工作 都 是 以 面向 测试 
的 方式 编写 的 ;这些 都 是 能 起 到 帮助 作用 的 一 些小 细节 。 
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ASPNET MVC 尽 其 所 能 地 启用 和 支持 了 测试 ,然而 , ASPNET MVC 不 会 编写 你 的 测试 ， 
对 你 应 用 程序 的 实际 结构 和 构成 层 也 一 无 所 知 。 你 的 目标 应 该 是 编写 相关 的 测试 ;而 不 应 该 
简单 地 追求 代码 的 高 履 亲 率 。 
1. 如 何 找 到 要 测试 的 相关 代码 
要 测试 的 相关 代码 的 位 置 主要 取决 于 代码 中 的 层 。 根据 第 7 章 中 所 讨论 的 , 我 的 意见 是 ， 
“不 要 把 它 放 在 控制 器 中 。” 很 多 强调 对 ASPNET MVC 提供 的 单元 测试 进行 支持 的 例子 都 仅 
限于 测试 控制 器 。 请 思考 下 面 的 代码 : 


[TestClassl| 
public class HomeControllerTest 
{ 
[TestMethod | 
public void Index () 
{ 
Var controller = new HomeController(); 
Var result = controller.Index() as ViewResult.; 
Assert.AreEqual ("Welcome to ASP.NET MVC!", result.ViewBag.Message); 


} 
} 
该 测试 创建 了 一 个 控制 器 类 的 新 实例 ， 并 调用 了 Index 方法 。 该 方法 会 返回 一 个 
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ViewResult 对 象 . 然 后 断言 会 检查 ViewResult 实例 中 的 Message 属性 是 否 等 于 指定 的 字符 串 。 
让 我 们 在 此 处 回顾 一 下 访 控 制 攻 的 代码 : 


public ActionResult Index() 


{ 
ViewBag.Message = "Welcome to ASP.NET MVC!"™; 


return View({(); 
} 
此 代码 的 相关 部 分 是 任务 分 配 。 为 了 保持 控制 占 的 至 精 至 简 ， 你 应 该 考虑 将 这 段 代码 移 
到 工作 线程 服务 ， 如 第 7 章 中 所 讨论 的 。 下 面 是 如 何 重 写 该 方法 以 隔离 核心 远 辑 的 代码 : 


public ActionResult Index () 


{ 
service.GetIndexViewModel (ViewBag); 


return View({(); 
} 
此 时 ， 你 不 再 需要 测试 控制 器 了 。 你 也 许 会 想 要 测试 服务 类 。 可 能 存在 着 控制 器 方法 主 
体 有 点 朋 肿 的 情况 ;不 过 ， 大 部 分 是 由 条 件 语句 和 琐 雁 任务 构成 的 胶水 代码 一 没什么 真正 
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需要 你 测试 的 。 
可 以 将 同样 的 推论 应 用 到 工作 线程 服务 ， 引 领 你 为 具有 极其 清晰 和 有 限 断 言 的 高 度 专 用 
组 件 编写 测试 。 


注意 : 

在 编写 单元 测试 时 ， 你 需要 知道 很 多 有 关 你 要 测试 单元 的 内 部 详细 信息 。 事 实 上 ， 单 元 
测试 是 一 种 白 盒 测试 ， 与 黑 盒 测试 相反 ， 测 试 人 员 不 需要 了 解 内 部 信息 ， 并 且 将 测试 限定 于 
输入 指定 的 输入 值 和 期 待 指定 的 输出 值 。 


2. 域 层 


第 7 章 定 义 了 域 层 的 上 下 文 ， 它 涉及 应 用 程序 业务 上 下 文 的 恒定 对 象 一 数据 和 行为 。 
如 果 要 设计 一 个 电子 商务 应 用 程序 ， 你 的 域 会 主要 包括 像 发 票 、 客 尸 、 订 单 、 运 输 者 以 及 报 
价 这 样 的 实体 。 上 述 每 个 实体 都 有 属性 和 方法 。 例 如 ， 发 票 具 有 的 属性 有 “Number、Date、 
Payment 和 Items 等 ， 具 有 的 方法 有 GetEstimatedDayOfPayment、GetTotal 和 CalculateTaxes 
等 。 对 于 这 其 中 的 一 些 实体 (比如 聚合 根 ) 来 说 ， 你 可 能 还 需要 以 跨 实 体 方式 执行 特 设 操作 的 
特殊 服务 。 例 如 ， 你 可 能 希望 有 一 个 方法 能 获取 客户 信息 并 计算 出 她 是 否 下 了 足够 多 的 订单 
从 而 成 为 金牌 客户 。 

这 是 你 绝对 要 彻底 测试 的 一 部 分 代码 ; 也 就 是 说 ， 你 想 确 保 它 被 相关 的 单元 测试 广泛 履 
蓄 。 因 为 这 是 你 应 用 程序 的 核心 ， 所 以 你 会 希望 确保 你 过 到 了 所 有 适当 的 边界 情况 ， 并 正确 
地 检测 出 了 不 一 致 的 值 /状态 。 最 后 ， 你 想 确 保 一 系列 适当 的 测试 可 以 提醒 你 注意 在 开 友 后 期 
引入 的 所 有 回归 。 如 果 只 能 用 测试 履 产 应 用 程序 的 一 部 分 的 话 ， 我 建议 这 一 部 分 是 域 层 ， 如 
果 有 的 话 。 


3. 编排 技 


取决 于 你 真正 实现 的 层 数 和 层级 数 , 编排 层 (在 第 7 章 中 讨论 过 ) 既 可 以 由 ASPNET MVC 
控制 器 的 工作 线程 服务 完全 识别 ， 也 可 以 形成 其 自己 的 一 层 。 

测试 这 一 层 的 需求 完全 取 雇 于 你 在 其 中 所 拥有 的 逻辑 数量 。 在 创建 、 旋 取 、 更 新 和 删除 
(CRUD) 系 统 中 ， 这 一 层 通 贡 足够 精简 ， 只 需要 测试 它 的 样本 即 可 。 然 而 ， 如 果 表 示 层 提供 了 
与 存储 保存 的 数据 明显 不 同 的 数据 表示 形式 ， 编 排 层 则 会 负责 以 一 种 特定 于 视图 的 格式 来 安 
排 数据 。 在 这 种 情况 下 ， 这 一 层 会 成 为 你 应 用 程序 中 更 为 重要 的 一 部 分 ， 值 得 更 加 关注 。 

如 果 将 控制 器 简化 成 一 个 纯粹 的 传递 层 一 一 从 编排 层 获 取 视 图 模型 并 将 其 传递 到 
ASPNET MVC 基础 架构 一 一 就 没有 必要 对 其 进行 测试 。 或 者 ,更 好 的 是 , 你 首先 就 专注 在 应 
用 程序 的 其 他 部 分 了 。 


第 9 章 ASPNET MVC 中 的 测试 与 可 测试 性 


4. 数据 访问 层 


你 的 数据 访问 层 提 供 了 什么 服务 ? 它 只 是 为 你 运行 SQL 语句 吗 ? 如 果 是 这 样 的 话 , 在 你 
确定 代码 在 开发 时 能 正常 运行 (例如 ， 你 的 SQL 语句 是 正确 的 ) 之 后 ， 一 切 就 都 继续 了 。 

如 果 数 据 访 问 层 忠 结 了 额外 的 功能 ， 并 包含 了 一 些 将 数据 修改 成 与 存储 不 同 的 数据 结构 
的 逻辑 ， 你 可 能 就 需要 考虑 一 些 测 试 了 。 但是， 在 这 种 情况 下 ， 为 什么 不 把 CRUD 内 容 从 适 
配 右 外 学 中 分 离 出 来 ， 只 测试 适 配 妖 呢 ? 


重要 提示 : 

单元 测试 并 不 真 的 是 一 个 数字 问题 ; 而 是 一 个 数字 的 质量 问题 。 你 不 仅 需 要 测试 ， 还 需 
要 覆盖 代码 相关 方面 的 测试 。 你 不 可 能 因为 单元 测试 就 能 销售 出 应 用 程序 ， 但 会 因为 应 用 程 
序 通过 了 验收 测试 而 售 出 应 用 程序 。 而 有 全， 验收 测试 会 表明 何 种 行为 是 对 最 终 用 户 相关 的 。 
找 出 哪些 行为 与 构成 你 应 用 程序 的 代码 单元 有 关 ， 正 是 你 期 望 从 伟大 的 开发 人 员 那 里 学 到 的 
东西 。 


9.3.2 对 ASPNET MVC 代码 进行 单元 测试 


超出 单元 测试 理论 之 外 的 一 一 有 人 甚至 称 它 为 单元 测试 之 艺术 一 一 还 有 一 些 具体 而 务实 
的 方面 需要 你 处 理 。 具 体 来 说 ， 有 一 些 实践 和 技术 你 需要 理解 以 便 编写 用 于 ASPNET MVC 
应 用 程序 的 单元 测试 。 

编写 单元 测试 相当 于 调用 一 个 模拟 你 关注 的 特定 上 下 文 的 方法 。 单 元 测试 就 是 一 个 软 
件 一 一 一 个 类 中 的 方法 一 一 有 了 它 ， 就 像 软件 一 样 ， 可 以 使 用 在 常规 代码 类 中 所 使 用 的 大 部 
分 拉 巧 和 拉 术 。 在 这 一 章 中 ， 我 只 讨论 需要 知道 的 相关 方面 ， 而 非 ASPNET MVC 单元 贡 试 
的 每 一 个 方面 。 


注意 : 

如 果 对 单元 测试 的 艺术 感 兴 趣 , 务必 购 买 一 本 由 Roy Osherove 编写 的 着 作 The Art of Unit 

Testing(Manning Publications，2009 年 出 版 ), 可 以 在 http://www. manning.com/osherove 找到 ， 

1. 测试 返回 的 视图 是 否 正确 

可 能 存在 着 控制 右 动 态 决 定 要 呈现 的 视图 的 情形 。 当 要 呈现 的 视图 是 基于 茶 些 只 能 在 运 
行 时 获知 的 条 件 时 ， 就 会 发 生 这 种 情况 。 一 个 例子 是 ， 必 须 基于 区 域 设 置 、 用 户 账户 、 星 期 
几 、 或 任何 用 尸 可 能 要 求 的 条 件 来 切换 视图 模板 的 一 个 控制 器 方法 。 

在 测 试 中 ， 可 以 通过 使 用 ActionResult 对 象 的 ViewName 属 性 来 获得 正在 主 现 的 钢 , 
如 下 所 示 : 
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[TestMethodi 
public void Should Render Italian View() 
{ 


// Simulate ad hoc runtime conditions here 


// Parameters 
Var productId = 42; 


Var expectedViewName = "index it"; 

// Go 

Var controller = new ProductController (); 

Var result = controller.Find (product1Id) as ViewResult; 


1f (result == null) 
Assert.Fail (“Invalid result™); 
Assert.AreEqual (result .ViewName, expectedViewName); 
} 
假设 ProductController 类 会 为 所 选 产品 返回 本 地 化 视图 。 在 这 种 情况 下 ， 运 行 时 条 件 为 
了 测试 而 模拟 的 一 个 好 例子 是 将 其 设置 为 当前 区 域 。 
通过 检查 由 控制 器 方法 返回 的 特定 ActionResult 对 象 的 公共 属性 ， 你 还 可 以 在 生成 特定 
M9 如 JavaScript 对 象 标 记 (JSON)、JavaScript、 二 进 制 数 据 、 文 件 等 一 一 的 时 候 执 行 特 


2. 测试 本 地 化 


有 时 候 你 会 发 现 ， 做 一 些 快 速 检查 的 测试 ， 看 看 在 选择 了 某 种 特定 语言 时 用 户 界 面 的 某 
些 部 分 是 耕 会 得 到 适当 的 本 地 化 资源 是 非常 有 用 的 。 下 面 是 如 何 使 用 单元 测试 进行 检查 的 
代位 : 


[TestMethoad | 
public void Test If Localizated Strings Are Used () 
{ 
// Simulate ad hoc runtime conditions here 
const string culture = "it—IT"; 
var cultureInfo = CultureInfo.CreatespecificCulture (culture); 
Thread.CcurrentThread.CurrentCulture = cultureInfo,; 


Thread.CurrentThread.CurrentUICulture = cujtureInfo; 


// Ensure resources are being returned in the correct language 
var showMeMoreDetalils = MyText .Product .ShowMeDetall1s:; 


/:/ Assert 
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Assert.AreEqual (ShowMeMoreDetalls，"Magqdgqlor1l informazion1i"™"); 


在 单元 测试 中 ， 首 先 要 在 当前 线程 上 设置 区 域 性 ， 然 后 尝试 检索 资源 值 ， 并 且 根 据 预 期 
值 进行 断言 。 

可 以 使 用 这 一 技术 来 测试 与 本 地 化 相关 的 几乎 一 切 内 容 ， 包 括 局 部 视图 和 资源 。 下 面 是 
为 UrlHelper 扩展 方法 而 编写 的 单元 测试 ， 这 在 第 5 章 “ASPNET MVC 应 用 程序 特性 ”中 讨 


论 过 : 
[TestMethoad | 
public void Test If Url Extensions Work () 
{ 
// Data 
Var url = "sample.css"; 
Var expectedUrl1 = "sample.it.css"; 
// Set culture to IT 
const String culture = "it—IT™"; 
var cultureInfo = CultureInfo.cCreateSspecificCulture (culture); 
Thread.currentThread.cCcurrentcCulture = culturelInfo; 
Thread.currentThread.CurrentUICulture = culturelInfo; 
// Act & Assert 
Var localizedUrl = UrlExtensions.GetLocalizedUrl (url); 
Assert.AreEqual (localizedUrl, expectedUr]l); 
} 
这 一 快速 演示 隐藏 了 一 件 非常 有 趣 的 事情 ,第 5 章 显示 了 定义 GetLocalizedUrl 扩展 方法 


的 代码 ， 如 下 所 示 : 
public static String GetLocalizedUrl (UrlHelper helper, String resourceUrl]l) 


要 测试 此 方法 ， 你 需要 提供 一 个 UrlHelper 类 的 实例 。 可 惜 的 是 ，UrlHelper 类 的 构造 函 
数 是 与 ASPNET MVC 基础 架构 联系 在 一 起 的 。 


public UrlHelper (ReduestContext context) 


如 何在 测试 环境 中 得 到 一 个 有 效 的 RequestContext 呢 ? 你 需要 模拟 出 HITP 上 上 下文。 这 
绝对 是 可 行 的 事 ， 如 同 之 后 你 将 会 看 到 的 ， 但 在 这 个 方案 中 它 需 要 太 多 的 工作 了。 一 个 简单 
的 重 构 可 以 帮助 你 专注 于 真正 与 测试 相关 的 东西 。 

最 后 你 需要 的 是 检查 当 区 域 性 是 Italian 时 ,代码 返回 sample.it.css 而 非 sample.css 的 能 力 。 
你 不 需要 测试 代码 是 否 真 的 存在 于 Web 服务 器 上 。 因 此 ， 并 不 完全 需要 请 求 上 下 文 。 让 我 们 
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重 与 GetLocalizedUrl 方法 ， 如 下 所 示 : 


public static String GetLocalizedUrl]l (UrlHelper helper, String resourceUrl]l) 


{ 
Var Url = GetLocalizedUrl (resourceUrl}; 
return VirtualFileExists (helper, url) ? url : resourceUrl; 
} 
public static String GetLocalizedUrl (String resourceUrl]l) 
{ 

Var cultureExt = String.Format (™{0}{1}"™, 
Thread.CcurrentThread.CurrentUICulture.TwoLetterISOLanguageName, 
Path.GetExtension (resourceUr1l) ) ， 

return Path.changeExtension (resourceUril, cultureFExt); 

} 


其 效果 是 一 样 的 ， 但 测试 却 更 快 且 更 具有 针对 性 了 。 
3. 测试 重 定 向 


控制 器 操作 可 能 也 会 重 定向 到 另 一 个 URL 或 路 由 。 但 是 , 测试 重 定向 并 不 比 测试 特定 于 
上 下 文 的 视图 更 复杂 。 如 果 控 制 器 方法 重 定 同 到 特定 URL 的 话 ， 则 重 定向 会 返回 一 个 
RedirectResult 对 象 ; 然而 , 如 果 它 重 定 回 到 指定 的 路 由 ,就 会 返回 一 个 RedirectToRouteResult 

RedirectResult 类 具有 一 个 熟悉 的 Url 属性 ， 可 以 检查 以 验证 该 操作 是 否 成 功 完 成 了 。 
RedirectToRouteResult 类 具有 如 RouteName 和 RouteValues 这 样 的 属性 ,可 以 检查 以 确保 重 定 
回 工 作 正 第。 


4. 测试 路 由 


尤其 在 你 广泛 使 用 自 定 义 路 由 的 情况 下 ， 你 可 能 会 硕 望 仔 细 地 测试 它们 。 有 具体 来 说 ， 你 
关注 的 是 检查 指定 的 URL 是 否 匹配 到 了 正确 的 路 由 ， 以 及 路 由 数据 是 售 补 正确 地 提取 。 

要 测试 路 由 ， 你 必须 重建 global.asax 环境 ， 并 且 首 先 调 用 RegisterRoutes 方法 。 
RegisterRoutes 方法 填充 了 有 具有 可 用 路 由 的 集合 ， 如 以 下 所 示 : 


[TIestMethoad | 
public vold Test If Product Routes WorK () 
{ 
// Arrange 
Var routes = new RouteCollection (); 
MvcApplication.ReglsterRoutes (outes) ; 
RouteData routeData = null; 


// Act & Assert whether the right route was found 
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var expectedRoute = "{controller}/{action}/{1id}"; 

routeData = GetRouteDataForUrl ("~/product/id/123", routes); 

Assert.AreEqual(((Route) routeData.Route) .Url, expectedRoute).; 
} 


测试 中 的 GetRouteDataForUrl 方法 是 一 个 本 地 帮助 器 ， 定 义 如 下 : 


private static RouteData GetRouteDataForUTr1 (String url, RouteCollection routes) 


{ 
Var httpContextMock = new Mock<HttpContextBase> (); 


httpContextMock.Setup(c => Cc.Request. 
AppRelativeCurrentExecutionFilePath) .Returns (url); 

Var routeData = routes.GetRouteData (httpContextMock).; 

Assert.IsNotNull (routeData, "Should have found the route™); 

return routeData; 

} 

该 方法 预计 将 调用 GetRouteData 来 检索 有 关 所 请 求 路 由 的 信息 。 可 惜 的 是 , GetRouteData 
需要 一 个 对 HttpContextBase 的 引用 ， 它 会 放置 所 有 有 关 请 求 的 查询 。 尤 其 是 ，GetRouteData 
需要 调用 AppRelativeCurrentExecutionFilePath 以 了 解 要 处 理 的 虚拟 路 径 。 通 过 模拟 
HttpContextBase 以 提供 特 设 的 URL, 你 就 可 以 将 路 由 从 运行 时 环境 中 完全 解 丰 出 来 并 用 断言 
进行 处 理 。 

前 面 所 示 的 示例 代码 使 用 了 Moq 框架 来 创建 测试 替身 。 让 我 们 进一步 了 解 模拟 以 及 如 何 
利用 模拟 来 抵消 或 蔡 换 依赖 性 。 


9.3.3 ”处 理 依赖 性 


就 测试 而 言 ， 可 以 说 有 两 个 主要 类 型 的 依赖 性 :那些 你 想 要 忽略 的 ， 以 及 那些 你 想 要 与 
其 交互 但 要 以 受 控 的 方式 进行 的 。 在 这 两 种 情形 下 ， 你 都 需要 提供 一 个 测试 蔡 身 对 象 一 即 
在 提供 预期 性 能 的 同时 表现 得 也 像 预 期 的 对 象 。 如 果 被 测试 的 类 支持 依赖 注入 (DD， 提 供 测 
试 蔡 身 就 是 小 菜 一 碟 了 。 

无 论 用 来 表示 测试 替身 伪造、 模拟、 存根) 的 名 称 是 什么 ， 纯 粹 的 事实 是 你 需要 一 个 实 
现 指定 协议 的 对 象 。 那 么 ， 如 何 编写 一 个 这 样 的 测试 蔡 身 对 象 呢 ? 

1. 关于 模拟 和 伪造 对 象 

测试 替身 是 由 你 编写 并 添加 到 测试 项 目 中 的 一 个 类 。 这 个 类 实现 指定 的 接口 ， 或 继承 自 
一 个 指定 的 基 类 。 在 有 了 该 实例 以 后 ， 通 过 使 用 被 测试 对 象 的 公共 接口 将 其 注入 到 受 测 对 象 
的 内 部 (很 明显 ， 我 假定 受 测 对 象 的 设计 考虑 了 可 测试 性 要 求 )。 

可 能 每 一 个 你 编写 的 测试 都 需要 一 个 不 同 的 测试 替身 。 这 些 类 看 起 来 几乎 相同 ， 但 它们 
所 返回 的 值 可 能 会 不 同 。 你 真 的 需要 编写 和 维护 成 百 上 千 个 类 似 的 类 吗 ? 当然 不 用 ， 这 就 是 
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模拟 框 染 存 在 的 理由 。 模 拟 框 染 为 你 提供 了 快速 创建 能 够 实现 协议 的 类 的 基础 架构 。 男 外 ， 
模拟 框架 还 提供 了 一 些 工 具 ， 可 以 用 来 配置 与 该 动态 创建 的 类 方法 的 交互 。 尤 其 是 ， 可 以 指 
示 模 拟 获 得 一 个 公开 ISomething 协议 的 类 的 实例 ， 并 且 在 用 指定 参数 调用 ExecuteTask 方法 
时 返回 1。 

当 你 需要 在 一 个 或 多 个 方法 的 实现 中 保持 某 种 状态 或 执行 某 些 自 定义 逻辑 时 ， 大 概 会 需 
要 编写 你 目 己 的 类 。 在 这 本 书 的 上 下 文中 ， 我 将 伪造 称 为 你 在 测试 项 目 中 编写 的 专用 于 消除 
依赖 性 的 类 。 我 将 模拟 称 为 你 使 用 模拟 框架 创建 的 用 于 相同 目的 的 类 。 

你 仍然 认为 伪造 和 模拟 之 间 存在 相关 性 差异 吗 ? 如 果真 的 存在 ， 也 只 是 你 希望 附加 给 它 
们 的 标签 轻 了 。 


2. 执行 数据 访问 的 测试 代码 


DI 在 测试 中 的 典型 例子 是 ， 当 你 有 一 个 工作 线程 服务 类 (在 简单 的 情形 中 甚至 可 以 是 控 
制 嚣 类) 时， 需要 执行 数据 访问 操作 。 第 7 草 定 义 了 一 个 从 存储 库 中 获取 日 期 列表 的 名 为 
HomeService 的 工作 线程 服务 类 。 该 服务 类 被 用 来 在 把 日 期 列表 封装 进 用 于 显示 的 视图 模型 
之 前 对 其 做 一 些 额外 的 工作 。 尤 其 是 ， 工 作 线 程 服务 会 计算 当前 日 期 与 指定 日 期 之 间 的 时 间 
跨度 。 存 储 库 可 能 会 运行 一 些 数据 库 查 询 以 返回 日 期 。 下 面 是 如 何在 服务 类 中 注入 伪造 依赖 
性 的 代码 ， 以 便 可 以 在 不 处 理 查 询 和 连接 字符 串 的 情况 下 测试 服务 类 : 


[TestClass | 
public class DateRepositoryTests 
{ 
[TestMethod | 
public void Test If Dates Are Processed () 
{ 
Var inputDate = new DateTime (2013, 2, 8); 
Var fakeRepository = new FakeDateRepository (); 
Var service = new HomeServices (fakeRepository); 
var model = service.GetHomeViewModel (); 


Var expectedResult = (Int32) (DateTime.Now - inputDate) .TotalDays; 
Assert.AreEqual (model .FeaturedDates [0] .DaysToGo, expectedResult); 
} 
FakeDateRepository 类 看 起 来 如 下 : 


public class FakeDateRepository : IDateRepository 

{ 
public override IList<MementoDate> GetrFeaturedDates () 
{ 
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return List<MementoDate> 
{ 


new MementoDate {Date = new DateTime(...)} 


ys 


} 

你 打算 编写 的 每 个 测试 都 需要 一 个 新 的 FakeDateRepository 类 。 例 如 ， 假 设 你 希望 在 指 
定 日 期 到 来 之 前 和 当前 日 期 之 后 都 要 测试 服务 行为 。 你 需要 两 个 测试 以 及 两 个 版 本 略微 不 同 
的 FakeDateRepository， 区 别 仅 在 于 所 返回 的 日 期 。 下 面 的 代码 揭示 了 模拟 框架 是 如 何 起 到 帮 


助 作 用 的 : 
[TestClass | 
public class DateRepositoryTests 
{ 
[TestMethod | 
public void Test If Dates Are Processed() 
{ 
Var inputDate = new DateTime (2012, 2, 8); 
Var fakeRepository = new Mock<IDateRepository> () ; 
fakeRepository.Setupl(d => d.GetrFeaturedDates ()) .Returns 
(new List<MementoDate> 
{ 
new MementoDate {Date = InputDatel 
}); 
Var SerVlce = new HomeServices (fakeRepository.Object); 
Var model = service.GetHomeViewModel (1) : 
Var expectedResult = (Int32) (DateTime.Now - inputDate) .TotalDays; 
Assert.AreEqual (model .FeaturedDates[0|] .DaysToGo, expectedResult); 
} 
} 


伪造 存储 库 是 通过 使 用 Moq 创建 的 ， 并 通过 构造 国 数 注入 HomeService 类。 
Mock<IDateRepository> 对 象 是 -个 动 态 创 建 的 类 (Moq 在 内 部 使 用 Castle DynamcProxy 来 动 
态 生成 代码 )， 每 当 调 用 GetFeaturedDates 方法 的 时 候 ， 它 就 会 实现 IDateRepository 接口 并 返 
回 输入 的 日 期 。 要 编写 针对 另 一 个 输入 的 测试 ， 你 不 需要 显 式 处 理 源 类 ， 和 直接 重复 测试 方法 
就行 。 

9.3.4 模拟 HTTP 上 下 文 
当 不 得 不 模拟 HITP 上 下 文 以 编写 某 些 ASPNET MVC 单元 测试 时 ， 让 我 感到 不 舒服 。 
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有 时 候 ， 你 确实 需要 它 ;， 然 而 ， 更 多 的 情况 往往 是 ， 在 你 的 代码 上 进行 一 点 重 构 就 行 了 ， 并 
没有 必要 模拟 HTTP 上 下 文 。 

在 面 对 单 元 测试 时 ， 我 经 常会 发 现 一 个 错误 (全 少 我 称 它 为 错误 )。 一 些 开 发 人 员 似 乎 无 
法 看 控制 器 级 别 以 外 的 内 容 。 这 些 开 发 人 员 在 控制 右 中 放 入 了 大 量 的 人 逻辑 。 他 们 很 少 利 用 特 
定 的 、 高度 专用 的 类 。 这 些 开 发 人 员 似 乎 认为 在 控制 器 以 外 , 你 只 能 使 用 一 个 微软 SQL Server 
数据 库 或 实体 框架 模型 。 有 一 个 围绕 LINQ-to-Entities 查询 的 存储 库 层 就 已 经 是 一 个 前 沿 的 解 
决 方案 了 。 第 7 章 竹 试 了 对 纯 代 码 的 一 种 不 同 模 式 进 行 阐述 。 

如 果 控 制 器 方法 的 粒度 相当 粗大 ， 你 便 不 可 避免 地 需要 模拟 一 长 串 运 行 测试 的 对 象 。 直 
接 处 理 得 询 字 符 串 和 会 话 状态 的 控制 器 方法 需要 有 一 个 有 效 的 HITP 上 下 文 来 安排 要 运行 
的 测试 。 这 是 你 的 一 项 额外 工作 。 另 外 ， 重 构 添 加 封装 和 包装 器 的 控制 右 方 法 也 是 你 的 额外 
工作 ， 但 它 是 另 一 种 类 型 的 工作 。 

你 很 快 就 可 以 看 到 简洁 设计 的 好 处 了 : 痛 先 ， 测 试 变 得 更 加 容易 。 为 让 测试 能 正常 工作 
会 耗费 很 多 精力 ， 结 果 却 是 浪费 了 更 多 的 时 间 。 当 测试 最 终 开 始 运行 时 ， 你 感到 的 是 安心 而 
不 是 满意 。 如 果 最 终 得 到 的 是 粗 粒 上 度 的 控制 嚣 方法， 那么 模拟 HITP 上 下 文 就 会 成 为 一 个 持 
续 不 断 的 需求 。 它 不 仅 古 ASPNET MVC 框架 所 需要 的 ， 它 最 终 也 会 古 你 目 己 所 证 要 的 。 

然而 ， 话 虽 如 此 ， 有 时 候 你 却 真 的 需要 模拟 HITP 上下文。 让 我 们 看 看 怎么 进行 。 


1. 模拟 HttpContext 对 象 


HttpContext 对 象 继 承 自 HttpContextBase， 你 所 需要 做 的 就 是 为 它 创 建 一 个 模拟 。 
HttpContext 对 象 是 对 象 引 用 的 一 个 普通 聚合 ; 它 几 乎 不 需要 包含 额外 的 代码 。 所 以 ， 大 多 数 
情况 下 模拟 部 会 运行 民 好 。 下 面 是 如 何 使 用 Moq 构建 一 个 伪造 HITP 上 下 文 的 代码 : 


public void BuildHttpContextForController (Controller controller) 
{ 

var contextBase = new Mock<HttpContextBase> () 7 

var request = new Mock<HttpRequestBase> () 7， 

Var response = new Mock<HttpResponseBase> (); 

Var server = new Mock<HttpServerUtilityBase> (); 


contextBase.Setupl(c => c.Request) .Returns (request); 
CoOntextBase -Setup (tc => Cc.Response) .Returns (response); 
contextBase.sSetup(c => c.Server)}) .Returns (server}); 


// Pass the fake context down to the controller instance 
var Context = new ControllerContext( 

new RequestContext (contextBase.Object, new RouteData()), controller),; 
controller.controllerContext = context,; 
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return; 

} 

这 只 是 模拟 ASPNET 内 部 对 象 的 第 一 层 而 已 。 例 如 ， 每 当 应 用 程序 在 单元 测试 中 查询 
Request 时 ， 它 就 会 获得 模拟 对 象 。 但 是 模拟 对 象 是 一 个 虚拟 对 象 ， 并 且 和 需要 其 自己 的 设置 。 
让 我 们 来 看 几 个 例子 。 

2. 模拟 Request 对 象 


你 可 能 希望 按照 与 一 些 特定 成 员 有 关 的 预期 来 扩展 模拟 的 Request 对 象 。 例 如 ， 下 面 是 
如 何在 测试 中 模拟 GET 或 POST 请 求 的 代码 : 


Var method = "get™; 
contextBase.sSetupl(lc => Request .HttpMethod) .Return (method); 


在 本 章 前 和 讨 论 测 试 路 由 时 ， 我 们 也 僧 见 过 类 似 的 代码 : 


var HTL = sue? 
contextBase.Expect (c => Request.AppRelativeCurrentExecutionFilePath). 
Return (url).; 


你 大 概 不 想 使 用 Request.Form 对 象 从 控制 右 内 部 读 取 提 交 的 数据 ， 因 为 你 可 能 会 友 现 模 
型 绑 定 器 更 有 效 。 然 而 ， 如 果 一 个 控制 器 方法 中 有 一 个 对 RequestForm[“MyParam2] 的 旧式 调 
用 ， 你 该 如 何 测试 它 呢 ? 

// Prepare the fake Form collection 


var formCollection = new NameValueCollection ()}); 
formCollection["MyParam"] = ...)} 


// Fake the HTTP context and bind Request.Form to the fake collection 
var contextBase = new Mock<HttpContextBase> (); 


contextBase.Setupl(c => C.Reduest .Form) .Returns (formCollection); 


/:/ Assert 


这 样 ， 每 一 次 你 的 代码 通过 Request.Form 读 取 内 容 ， 它 实际 最 终 都 是 从 为 测试 目的 而 提 
供 的 名 称 / 值 集合 中 读 取 的 。 


3. 模拟 Response 对 象 
让 我 们 来 看 几 个 与 Response 对 象 有 关 的 例子 。 例 如, 你 可 能 想 通 过 将 HttpResponse 对 象 
强制 写 入 文本 编写 器 对 象 来 模拟 Response.Write 调用 ， 如 下 所 示 : 
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Var writer = new StringWriter (); 
Var contextBase = new Mock<HttpContextBase> ();，; 
contextBase.Setupl(c => c.Response) .Return (new FakeResponse (writer)); 


在 此 种 情况 下 ，FakeResponse 类 的 使 用 如 下 所 示 : 


Public class FakeResponse : HttpResponseBase 


{ 


} 


有 J 了 这 段 代 码 ， 你 就 可 以 对 具有 Response.Write 调用 的 控制 器 方法 进行 测试 了 了 ， 


private readonly TextWriter writer; 
public FakeResponse (TextWriter writer) 


{ 


writer = writer: 


public override voild Write(string msd) 
{ 


writer.Write (msd) ; 


所 示 的 这 个 : 


public ActionResult Output () 


{ 


} 


HttpContext .Response .Write ("Hello"); 
return View(); 


以 下 是 其 测试 


[TestMethodi 
public void Should Response Write() 


{ 


// Arrange 
Var writer = new StringWriter () :; 
var contextBase = new Mock<HttpContextBase> (}; 


如 下 面 


contextBase.Setup(c => c.Response) .Returns (new FakeResponse (writer)); 


Var controller = new HomeController(); 
controller.controllerContext = new Controllercontext ( 
contextBase.Object, new RouteData(), controller); 


/i Act 
Var result = Controller.Output () as ViewResult; 
1f (result == null]l) 
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ASSert -Fall("Result 1s5 null™); 


/ / Assert 


Assert.AreEqual ("Hello", writer.TosString()); 
} 


类 似 的 ， 如 果 要 让 荣 些 属性 或 方法 返回 特定 的 值 ， 就 可 以 配置 一 个 动态 生成 的 模拟 。 下 
面 是 两 个 例子 : 


VaT ContextBase = new Mock<HttpContextBase> () ; 


// Mock up the Output property 


contextBase.Setupl(c => Response.Output) .Returns (new StringWriter () ) ; 


// Mock up the Content type of the response 


contextBase.Setupl(c => Response.ContentType) .Returns ("application/Jjson"); 


另 一 方面 ， 对 于 cookies， 你 可 能 希望 同时 在 Request 和 Response 上 模拟 Cookies 集合 以 
返回 HttpCookieCollection 类 的 一 个 新 实例 ， 它 将 充当 你 单元 测试 范围 的 cookie 容器 。 在 本 
章 后 面 讨 论 如 何 用 操作 算 选 器 测试 控制 右 方 法 时 ， 我 会 介绍 更 多 有 关 模 拟 Response 对 象 的 


信息 。 
4. 模拟 Session 对 象 


模拟 更 易于 使 用 ， 但 有 时 你 需要 给 模拟 对 象 的 各 种 方法 分 配 一 个 行为 。 当 行为 如 返回 一 
个 指定 值 这 样 简 单 时 ， 这 是 容易 做 到 的 。 但 是 ， 为 了 有 效 测 试 该 方法 是 否 正 确 地 更 新 会 话 状 
态 ， 你 需要 提供 一 个 内 存 中 的 对 象 来 模拟 原始 对 象 的 行为 和 上 有 具备 存储 信息 的 能 力 ， 而 这 却 不 
是 一 个 简单 的 模拟 任务 。 不 过 ， 使 用 一 个 伪造 会 话 类 便 可 以 使 其 简单 明了 。 下 面 是 用 于 会 话 
状态 的 一 个 简约 却 有 效 的 伪造 : 

public class FakeSesslon : HttpSessionstateBase 

{ 

private readonly Dictionary<Sstring, Object> sessionItems = 


new Dictionary<Sstring, Object> (); 


public override vold Add (string name, Object value) 
{ 
sesslionItems .Add (name, value); 


} 
public override Object this[SsString name] 


{ 


Get { return sessionItems.ContainsKey (name ) ? sessionItems [name] 
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} 


null; } 
set { sesslionItems [name] = Value; } 


下 面 的 代码 显示 了 如 何 安排 一 个 测试: 


[TIestMethod | 
public vold Should Write To Session State () 


{ 


} 


// Arrange 

Var contextBase = new Mock<HttpContextBase> () 7 

contextBase.Setupl(c => c.Session) .Returns (new FakeSession ()); 

var Controller = new HomeController(); 

controller.CcontrollerContext = new ControllerContext ( 
contextBase.0Object, new RouteData(), controller); 


// Act 

Var expectedResult = "green"; 

controller.SetcColor (); // Runs Session["PreferredColor™"] = "green"™; 
// Assert 


Var result = controller.HttpContext.Session["PreferredColor"]; 
Assert.AreEqual (result, expectedResult); 


如 果 挥 制 右 方法 仪 证 取 目 Session, 那么 你 的 测试 可 以 更 人 简单 ,可 以 避免 完全 伪造 Session。 
下 面 是 一 个 控制 器 操作 示例 : 


public ActionResult GetColor () 


{ 


} 


Var 0 = Session["PreferredColor™]; 
1f (o == null) 

ViewDatal["Color"] = "No preferred color"; 
else 


ViewDataf"Color"] oO as String; 


return View ("Color™).; 


下 面 的 代码 片段 显示 了 测试 刚才 所 示 方 法 的 一 种 可 能 方式 : 


// Arrange 
Var contextBase = MockRepository.GenerateMock<HttpContextBase> ();，} 
contextBase.Expect(s => s.Session["PreferredColor™".]) .Return ("Blue™); 
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var controller = new HomeController(); 
controller.controllerContext = new Controllercontext( 
contextBase.Object, new RouteData(), controller); 


/:/ Act 
Var result = controller.GetColor() as ViewResult:; 
1f (result == nullil) 


Assert.Fail ("Result 1s null™). 


// Assert 
Assert.AreEqual (result .ViewData{["Color™"] .ToStrlng()， "Blue"™"); 


在 这 种 情况 下 ,可 以 指示 HTTP 上 下 文 模拟 在 请 求 其 Session 属 性 提供 用 于 “PreferredColor” 
条 目的 值 时 返回 “Blue” 字 符 串 。 

对 于 控制 器 的 方法 需要 读 取 和 写 入 会 话 状 态 这 一 更 常见 的 方案 ， 你 需要 使 用 一 些 基 于 
FakeSession 类 有 的 测试 解决 方案 。 


5. 模拟 Cache 对 象 


模拟 ASPNET Cache 对 象 是 一 个 值得 注意 的 任务 ， 虽 然 模拟 缓存 层 不 需要 新 的 方式 。 
HttpContextBase 类 有 一 个 Cache 属性 ， 但 你 不 能 模拟 它 ， 因 为 该 属性 并 不 代表 ASPNET 绥 
存 系统 的 一 个 抽象 ， 相 反 ， 它 是 特定 类 的 具体 实现 。 下 面 的 代码 显示 了 Cache 属性 是 如 何在 
HttpContextBase 关上 进行 正 明 的 : 

public abstract class HttpContextBase : lIServiceProvider 


{ 
public virtual Cache Cache { get; } 


} 

Cache 属性 的 类 型 实际 上 是 System.Web.Caching.Cache 一 一 真正 的 缓存 对 象 ， 而 不 是 一 个 
抽象 。 更 不 幸 的 是 ，Cache 类 型 是 密封 类 ， 因 此 不 具备 可 模拟 性 ， 也 无 法 在 单元 测试 中 使 用 。 

为 此 你 能 做 什么 呢 ? 有 两 个 选项 。 一 个 选项 需要 使 用 能 够 处 理 密封 类 的 测试 工具 。 举 例 
来 说 ， 其 中 的 一 个 工具 是 Typemock Isolator( 一 球 商 业 产 品 );， 男 一 个 工具 是 微软 Moles。 男 一 
种 可 选项 是 使 用 一 个 包装 类 从 你 打算 测试 的 任何 代码 中 执行 对 Cache 的 访问 。 第 5 章 检 验 了 
这 种 方法 。 

根据 你 的 所 见 ， 创 建 一 个 实现 指定 接口 的 缓存 服务 对 象 ;， 比如 ICacheService。 接 着 ， 你 
要 在 global.asax 中 辣 应 用 程序 注册 该 类 ， 并 添加 一 个 公共 的 静态 属性 来 读 写 缓存 : 


protected void Application Start() 
{ 
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// Inject a global caching service (for example, one based on ASP.NET Cache) 
ReglsterCacheService (new AspNetCacheService ()); 


private static ICacheService internalCacheObject; 
Public void ReglisterCacheService (ICacheService cacheService) 
{ 


internalCacheObject = cacheService; 


Public static ICacheService CacheService 
{ 
get { return internalCacheObject; } 


} 
在 控制 占 方 法 中 ， 你 要 完全 停止 使 用 HttpContextCache。 而 你 的 控制 器 会 有 以 下 设计 : 


public partial class HomeController : Controller 
{ 
public ActionResult SetCache () 
{ 
// MycApplication 1s the name of the global.asax class; change it at will 
MvcApplication.CacheService["PreferredColor"™"] = "Blue"™; 
return View(); 


} 
如 何 对 此 进行 测试 呢 ? 下 面 有 一 个 示例 : 


[TestMethodi 

public vold Should Write To Cache() 

{ 
// Arrange 
var fakeCache = new FakeCache () :; 
MvcApplication.ReglisterCacheService (fakeCache); 


// Act 
controller.setCache () : 


// Assert 
Assert.AreEqual ("Blue"，ftakeCcache ["PreferredColor"] .ToStrlng() ) ; 


第 9 章 ASPNET MVC 中 的 测试 与 可 测试 性 


FakeCache 类 可 以 是 这 样 的 : 


public class FakeCache : ICacheService 
{ 
private readonly Dictionary<string, Object> cacheItems = 
new Dictionary<string, Object> () :; 


public object this[String namel] 


{ 
get 
{ 
if ( cacheItems .ContalnSsKey (name) ) 
return cacheItems [name|; 
else 
return null; 
} 
set { _ CacheILems [name| = value; } 
} 


} 


用 这 种 方式 ， 你 就 可 以 测试 控制 器 方法 和 服务 ， 其 至 当 缓 存 是 分 布 式 缓存 时 也 可 以 使 用 
缓存 数据 。 绥 存 服务 隐藏 了 所 有 细节 ， 并 且 使 应 用 程序 更 具有 扩展 性 和 可 测试 性 。 


9.4 本草 小 结 


可 测试 性 是 软件 的 一 个 基本 方面 ， 正 如 ISO/EC 9126 论文 在 1991 年 所 认可 的 那样 。 在 
ASPNET MVC 中 ， 对 代码 的 可 测试 性 设计 更 为 容易 且 更 受 支 持 。 但 是 ， 也 可 以 在 ASPNET 
Web Forms 中 编写 测试 代码 并 在 很 大 程度 上 进行 测试 。 可 测试 性 是 追求 优秀 设计 的 极 佳 理 由 。 
设计 束 这 样 产 生 了 老 别 。 

我 们 都 赞同 编写 测试 是 有 益 的 、 值 得 推荐 的 、 甚 至 是 吝 有 魅力 的 。 然 而 ， 除 非 你 将 其 与 
一 些 测 试 驱 动 的 设计 方法 相关 联 ， 人 否则 编写 测试 本 里 就 会 面临 耗费 极 大 工作 量 的 风险 。 一 方 
面 ， 你 有 要 测试 的 类 ， 男 一 方面 ， 你 还 有 要 确保 能 够 测试 其 他 类 的 类 。 并 且 ， 你 没有 任何 中 
间 层 可 以 保证 测试 是 适当 和 有 意义 的 。 

创建 用 于 更 有 效 重 构 的 环境 同时 不 排除 单元 测试 的 方式 是 基于 软件 协议 。 软 件 协议 会 为 
每 个 类 中 的 每 个 方法 定义 条 球 和 条 件 。 这 就 为 你 提供 了 一 个 可 选 的 运行 时 检查 机 制 ， 以 及 在 
必要 时 如 何 重 构 的 具体 指导 。 软 件 协议 在 软件 中 并 不 是 一 个 新 概念 ， 但 它们 是 在 .NET 4 中 才 
开始 得 到 广泛 实施 的 ,请 在 MSDN 杂志 的 Cutting Edge 专栏 查看 代码 协议 的 相关 文档 和 我 写 
的 有 关 这 一 主题 的 文章 ， 其 网 址 是 http://msdn.microsoft.com/en-us/magazine/default.aspx。 
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空想 者 欺骗 自己 ， 而 骗子 只 欺骗 其 他 人 .， 
——Friedrich Nietzsche 


ASPNET Web API 是 一 个 新 的 框架 ， 其 明确 意图 是 支持 和 简化 可 以 由 各 种 客户 端 所 使 用 
的 HTTP 服务 的 构建 过 程 ; 尤其 是 HTML 网 页 和 移动 应 用 程序 。Web API 背后 的 核心 理念 并 
不 新 鲜 ， 开 发 人 员 和 架构 师 面 对 同样 的 挑战 至 少 已 经 十 年 了 。 一 路 走 来 ， 已 经 制定 了 几 种 框 
架 和 技术 ， 每 一 种 都 稼 常 被 作为 这 一 方面 的 最 终 解 决 方案 。 你 多 少 次 听 说 过 Windows 通信 基 
础 (WCF) 是 为 各 种 类 型 的 客户 端 打造 包括 TCP 和 HTTP 在 内 的 服务 层 的 理想 技术 了 ? 

在 这 方面 , Web API 至 少 是 最 新 的 尝试 一 一 并 且 希 望 会 是 最 后 的 真正 彻底 的 尝试 一 一 为 经 
由 了 HTTP 的 Web 服务 提供 理想 的 框架 。 

Web API 的 应 用 范围 非常 广泛 ， 对 任何 开发 人 员 来 说 都 是 令 人 信服 和 有 用 的 ， 不 仅仅 是 
Web 开发 人 员 。 但 是 ， 出 于 一 些 原因 ，Web API 有 时 候 会 被 当 作 与 ASPNET MVC 相关 的 工 
具 被 介绍 ， 或 者 让 人 感觉 是 与 ASPNET MVC 相关 的 工具 。 这 未 免 有 些 误导 ; 加 之 ， 如 果 看 
看 核心 功能 ，ASPNET MVC 开发 人 员 是 微软 市 场 领域 中 唯一 能 在 没有 Web API 的 情况 下 继 
续 恰 快 开发 的 人 了。 

Web API 是 一 个 精心 设计 的 框架 ， 它 用 于 为 .NET 应 用 程序 构建 RESTful( 具 象 状 态 传输 ) 
和 远程 过 程 调 用 (RPC) 风 格 HTTP 服务 。Web API 贯 军 了 ASPNET MVC 的 各 个 方面 ， 比 如 路 
由 、 安 人 全、 控制 器 和 可 扩展 性 ， 还 有 一 些 并 不 受 普通 ASPNET MVC 直接 文 持 的 特殊 领域 。 
总 之 ，Web API 应 该 有 一 本 恰如其分 地 叙述 其 所 涉及 内 容 的 书 。 这 一 章 会 羡 述 Web API 关键 
因素 的 执行 概要 一 一 如 何 构 建 和 使 用 HTTP 服务 一 一 从 ASPNET MVC 开发 人 员 的 角度 。 更 
多 示例 以 及 内 部 架构 的 更 深层 次 内 容 ， 我 建议 你 看 看 http://www.asp.net/web-api 的 优秀 文档 。 


10.1 Web API 的 来 龙 去 脉 


Web API 个 十 一 夜 之 间 出 现 的 框 染 ， 当 然 更 不 是 根据 什么 神灵 局 示 而 创造 出 来 的 框架 。 
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简单 地 说 ， 它 有 希望 成 为 大 约 十 年 前 就 已 经 开始 的 演变 进程 的 最 后 一 站 ， 其 目标 是 提供 标准 
化 的 Web 服务 。 


10.1.1 标准 化 HTTP API 的 需求 


在 被 绑 定 到 特定 的 技术 和 框架 之 前 ，Web 服务 一 词 仅 仅 用 于 摘 述 在 Web 上 可 用 的 软件 
服务 。 共 享 返回 数据 的 而 非 标 记 数 据 的 HTTP 端点 的 需求 在 20 世纪 90 年 代 后 期 就 已 经 非常 
强烈 和 明确 了 ， 当 时 ASPNET 框架 正在 制定 中 。 

就 像 常 常 发 生 在 软件 开发 中 的 那样 ， 架 构 师 设法 将 特定 的 需求 放 入 越 来 越 广 泛 的 上 下 文 
中 ， 最 终 创建 出 超越 了 解决 最 初 需求 的 技术 和 模式 。 经 过 几 年 的 发 展 后 ， 软 件 业界 叉 回 到 了 
最 初 的 需求 一 一 “我 们 需要 的 是 最 简单 的 基础 架构 ， 可 以 允许 我 们 通过 HTTP 调用 端点 。” 令 
人 惊讶 的 是 ， 在 ASPNET 和 微软 堆栈 内 部 以 及 周边 还 没有 这 种 基础 和 架构。 相反， 有 大 量 的 技 
术 可 以 让 开发 人 员 用 作 HTTP 服务 来 操作 ， 每 种 技术 都 有 其 上 自身 的 优 缺 点 。 

Web API 解 决 了 这 一 问题 ， 它 为 开 有 友人 员 提 供 了 一 个 有 效 而 独特 的 平台 来 通过 HTTP 公 
开 应 用 程序 服务 。“ 应 用 程序 服务 ”的 样式 和 结构 的 定义 取决 于 架构 师 。 它 可 以 是 将 应 用 程序 
发 布 到 Web 的 软件 开发 工具 包 (SDK)。 或 者 ， 也 可 以 是 Web 上 的 应 用 程序 的 SDK， 可 以 用 
可 控 的 方式 访问 ,但 又 不 公开 可 用 。 最 后 , 你 还 可 以 使 用 Web API 及 布 一 个 面 癌 服务 架构 (SOA) 
形式 的 服务 一 一 一 个 没有 用 户 界 面 的 目 主 、 独 立 的 应 用 程序 ， 只 以 各 种 格式 服务 于 数据 。 


1. 超越 WCF 


当 整 个 世界 认识 到 Web 服务 的 能 力 时 , 一 种 标准 协议 就 很 快 产生 了 , 该 协议 成 为 了 Web 
服务 可 以 与 调用 方 进行 交换 的 媒介 : 简单 对 象 访问 协议 (SOAP)。 最 重要 的 是 ， 很 多 更 深入 的 
规范 成 为 了 工作 进程 的 标准 ， 统 称 为 WS-* 协 议 。 

WCF 的 最 初 构想 是 透 过 种 类 党 多 的 传输 层 来 文 持 SOAP 和 WS-*, 这 些 传输 层 包括 TCP、 
消息 队列 (MSMQJ、 命 名 管道 ， 以 及 最 后 也 是 最 重要 的 一 个 : HTTP。 

不 难看 出 ， 虽 然 WCF 有 上 自己 坚实 的 发 展 动 机 和 理由 ， 但 开发 人 员 大 多 只 是 将 它 用 作 
HTTP 端点 的 快捷 方式 而 已 。 这 便 对 WCF 基础 架构 提出 了 更 有 效 文 持 非 SOAP 服务 的 要 求 ， 
以 达到 能 够 通过 HTTP 来 服务 纯 XML、 文 本 和 JavaScript 对 象 标 记 (JSON) 的 目的 。 这 些 年 来 ， 
我 们 先是 从 WCF 团队 获得 了 webHttpBinding 绑 定 机 制 , 接着 又 出 现 了 贴 附 式 框架 ,比如 REST 
入 门 套件 。 

上 归根结底， 这 是 提供 一 些 语 法 技巧 的 问题 ， 以 帮助 将 HITP 用 作 单 纯 运 输 层 这 一 想法 更 
容易 付 诸 实践 。WCF 之 上 的 HITP 设施 并 没有 消除 开发 人 员 所 面临 的 障碍 ， 比 如 声名 狼藉 的 
WCF 过 度 配 置 、 对 特性 的 过 度 使 用 以 及 其 结构 设计 未 特别 考虑 到 可 测试 性 方面 。 

主要 的 变化 是 将 多 传输 服务 从 普通 的 HTTP 服务 中 分 离 出 来 ， 并 且 消 除了 WCEF 的 所 有 
厚重 机 制 ， 创 建 了 一 个 精简 且 专 注 于 HTTP 框架 的 HTTP 服务 。 这 就 是 Web API。 
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注意 : 

随 着 服务 重点 从 WCF 转移 ， 是 否 意 味 着 WCF 就 变 成 了 吕 失 生命 力 的 技术 , 没有 实际 的 
应 用 程序 会 继续 使 用 了 呢 ? 当然 不 是 。 当 你 切实 需要 公开 一 个 可 以 通过 协议 调用 而 非 HITP 
调用 的 服务 时 ,WCF 就 是 唯一 重要 的 选择 。 当 你 真正 需要 如 安全 和 事务 处 理 支 持 这 样 的 高 级 
功能 时 ， WOCF 也 仍然 是 一 个 重要 的 解决 方案 。 


2. Web API 对 客户 端 应 用 程序 的 意义 


Web API 非常 适合 于 现在 似乎 很 常见 的 应 用 程序 场景 : 客户 端 应 用 程序 需要 调用 远程 后 
端 来 下 载 数据 或 请 求 处 理 。 客 户 端 应 用 程序 可 以 采用 多 种 形式 : ” JavaScript 密集 型 网 页 、 富 
客户 疹 或 移动 应 用 程序 。 

采用 这 些 形式 ，HTTP 协议 几乎 可 以 和 SOAP 一 样 有 效 ， 却 更 为 简单 和 快速 。 可 以 使 用 
HTTP 动词 和 标 头 来 标识 要 对 远程 资源 所 执行 的 操作 ;如 果 喜 欢 专注 于 操作 的 方式 ， 可 以 使 
用 URL 模板 来 表达 语义 。 无 论 哪 种 方式 , 你 都 要 使 用 消息 主体 来 序列 化 所 有 的 输入 值 和 接收 
内 容 。JSON 格式 是 在 客户 端 和 HTTP 服务 之 间 序 列 化 对 象 的 理想 格式 。 


3. Web API 对 ASP.NET Web Forms 应 用 程序 的 意义 


无 论 喜 欢 与 否 , 使 用 ASPNET Web Forms 的 网 站 数量 仍 远 远大 于 基于 ASPNET MVC 的 
网 站 数量 。 在 ASPNET 4 及 更 新 的 版 本 中 ， 微 软 设法 简化 了 问题 ， 比 如 加 入 了 生成 HIML 
的 受 限 访问 、 对 正在 生成 的 HTML 进行 更 好 的 控制 、 减 轻视 图 状态 和 路 由 的 影响 等 。 不 过 ， 
并 未 得 到 解决 的 一 个 问题 是 ， 如 何 让 Web Forms 开发 人 员 能 够 快速 公开 HTTP 可 调用 端点 。 

这 并 不 是 说 在 Web Forms 中 不 能 公开 HTTP 端点 以 从 客户 端 页 面 回 调 ; 可 以 将 HTTP 处 
理 程 订 或 WCF 服务 用 于 目 由 生成 JavaScript 代理 关 。 归 根 结 撒 ， 它 是 可 以 达成 该 任务 的 ， 但 
其 编码 过 程 让 开发 人 员 越 来 越 感觉 到 烦恼 。 

Web API 使 得 从 Web Forms 应 用 程序 中 公开 HTTP 服务 变 得 像 在 ASPNET MVC 中 使 用 
控制 右 一 样 简 单 : 只 要 添加 一 个 类 并 让 它 根 据 预 定义 的 路 由 规则 运行 即 可 。 不 豆 欢 默认 的 路 
由 规则 ? 没关系， 添加 你 自己 的 规则 也 很 简单 ! 

Web API 为 Web Forms 开发 人 员 带 来 了 巨大 的 好 处 。 不 过 同时 ， 它 也 代表 了 ASPNET 
MVC 开发 人 员 的 困惑 来 源 。 实 际 上 ， 和 第 碰 到 的 问题 是 ， 我 为 什么 应 该 使 用 它 呢 ? 相 较 于 
普通 的 控制 器 ，Web API 能 带 来 什么 好 处 ? 


10.1.2 ”MVC 控制 兹 与 Web API 对 比 


一 个 ASPNET MVC 应 用 程序 产生 自 多 个 控制 器 类 的 组 合 。 通 常 ， 每 个 控制 器 类 会 公开 
多 个 操作 以 便 用 户 界 面 可 以 通过 URL 调用 。 请 求 处 理 与 啊 应 生成 之 间 的 有 序 分 离 使 得 控制 器 
类 以 各 种 格式 返回 啊 应 成 为 了 可 能 ， 这 些 格式 包括 HIML、JSON、XML 以 及 普通 文本 。 
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针对 此 ， 在 ASPNET MVC 应 用 程序 中 使 用 Web API 有 什么 意义 呢 ? 
1. 控制 器 类 完成 所 有 工作 


如 果 想 要 从 ASPNET MVC 应 用 程序 内 部 返回 一 些 JSON 数据 ， 你 只 需要 在 新 的 或 已 有 
的 控制 器 类 中 创建 一 个 特 设 方法 即 可 .对 于 这 个 新 方法 的 唯一 特殊 要 求 是 返回 一 个 JsonResult 
对 象 ， 如 下 所 示 : 
public JsonResult LatestNews (int count) 
{ 
Var 11stofNews = _SerVlce.GetRecentNews (count); 


return Json(listOofNews, JsonRequestBehavior.AllowGet).; 


} 

该 方法 也 可 以 是 父 ActionResult 类 , 除了 声明 该 方法 的 返回 类 型 之 外 , 更 重要 的 是 对 Json 
方法 的 调用 。Json 方法 会 确保 指定 对 象 是 在 JsonResult 对 象 中 封装 的 。 在 其 从 控制 器 类 返回 
之 后 ，JsonResult 对 象 就 会 被 负 贡 当前 请 求 的 操作 调用 程序 处 理 。 

整体 作用 是 ,被 包含 的 对 象 一 一 由 控制 器 最 先 计 算 的 一 一 被 序列 化 到 JSON， 并 且 骨 入 到 
及 送 回 请 求 设 备 的 啊 应 主体 中 。 同 样 ， 可 以 为 普通 文本 、 二 进 制 内 容 ， 或 者 以 你 喜欢 的 方式 
格式 化 的 XML 内 容 提供 服务 。 


2. 了 解 不 同 之 处 


在 ASPNET MVC 中 ， 你 仅 会 因为 要 将 新 控制 器 类 或 特定 方法 添加 到 已 有 控制 器 类 而 使 
用 HTTP 服务 。 这 从 第 1 个 版 本 开始 就 是 有 效 的 并 且 到 目前 最 新 版 本 的 ASPNET MVC 中 仍 
然 有 效 。 那 么 你 为 什么 还 应 该 看 看 其 他 东西 呢 ? 
Web API 框架 依赖 于 一 个 不 同 的 运行 时 环境 ， 该 环境 完全 是 从 ASPNET MVC 的 运行 时 
环境 中 分 离 出 来 的 。 这样 做 的 目的 就 是 为 了 让 非 ASPNET MVC 应 用 程序 可 以 使 用 Web API。 
该 运行 时 环境 必然 很 大 程度 上 受到 了 ASPNET MVC 的 启发 ， 但 总 体 来 看 更 加 简单 并 且 更 为 
直截了当 ， 因 为 它 被 预期 仅 提 供 服务 而 非 标 记 。 
从 ASPNET 开发 人 员 的 视角 来 看 ， 以 下 三 个 要 点 总 结 了 Web API 方式 相对 于 ASPNET 
e 从 结果 序列 化 中 解 看 代码 ”这 指 的 是 Web API 控制 器 需要 你 从 每 个 方法 中 仅 返 回 数 
据 而 不 在 方法 内 部 对 结果 进行 序列 化 处 理 的 情况 。 

e 内 容 协 商 “ 称 为 格式 化 器 的 一 套 新 系列 组 件 会 负责 序列 化 返回 到 请 求 设备 的 数据 。 更 
为 相关 的 是 ， 格 式 化 器 是 根据 传 入 请 求 Accept 标 头 的 内 容 自动 选择 的 。 提 供 了 内 置 
的 XML 和 JSON 格式 化 器 ;， 蔡 换 它们 是 一 项 简单 的 配置 任务 。 该 特性 简化 了 可 能 会 
以 各 种 格式 返回 相同 原始 数据 的 方法 的 开发 ， 最 典型 的 是 XML 和 JSON 格式 。 
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e 在 互联 网 信息 服务 (IIS) 之 外 托管 ”从 某 种 程度 上 讲 ， 内 容 协 商 这 一 特性 也 能 在 普通 的 
ASPNET MVC 中 实现 。 但 是 ,如 果 选 择 在 ASPNET MVC 应 用 程序 中 实现 你 的 HITP 
服务 ， 那 么 你 就 要 绑 定 到 IIS 作为 Web 服务 器 ; 换 名 话说， 你 不 能 在 其 他 地 方 托管 你 
的 API。 这 是 由 于 ASPNET MVC 原生 就 是 绑 定 到 IS 的 ， 因 为 它 最 初 昌 在 作为 框架 
为 Web 应 用 程序 提供 服务 。 但 是 ，Web API 并 不 依赖 IS， 并 且 可 以 在 你 自己 的 托管 
进程 中 对 其 进行 自 托 管 ， 比 如 Windows 服务 或 控制 台 应 用 程序 (这 一 特性 使 得 Web 
API 服务 接近 于 WCF 服务 )。 
从 本 质 上 讲 ，Web API 并 没有 真 的 为 ASPNET MVC 开发 带 来 太 多 潜力 ， 所 以 也 不 要 将 
其 看 作 是 一 个 必要 特性 ， 例 如 ， 它 在 Web Forms 开发 中 就 并 非 必要 特性 。 通 常 ， 它 的 使 用 依 
赖 于 特定 项 目的 需求 ， 并 且 一 定 程度 上 取 诀 于 开发 团队 的 偏好 。 


3. 构建 RESTful 应 用 程序 


如 果 过 去 曾 努 力 使 ASPNET MVC 控制 器 尽 可 能 贴近 RESTful， 你 会 发 现 通过 选择 Web 
API 并 相应 地 组 织 Web 应 用 程序 会 使 该 任务 更 易 达成 。 例 如 ， 可 以 使 用 主要 是 客户 端的 解决 
方案 (比如 单 页 面 应 用 程序 ) 或 者 许多 服务 器 端 网 页 来 通过 该 API 的 直接 HTTP 调用 完成 大 多 
数 工 作 ， 以 创建 、 读 取 、 更 新 和 删除 (CRUD) 数 据 。 

要 构建 一 个 RESTful 应 用 程序 ， 你 必须 识别 出 应 用 程序 中 的 不 同 资源 并 将 基于 这 些 资源 
执行 的 操作 映射 到 HTTP 方法 进行 处 理 。 有 了 Web API， 这 在 很 大 程度 上 就 变 成 自然 而 然 的 
了 ;你 所 要 做 的 就 是 ， 定 义 一 个 数据 转换 对 象 以 返回 到 客户 端 并 制定 一 个 在 宿主 ASPNET 
MVC 应 用 程序 中 的 类 以 基于 该 对 象 执行 基础 的 CRUD 操作 。Web API 能 保障 解决 方案 的 
RESTfulness， 它 确保 了 将 HTTP PUT 请 求 映 射 到 创建 操作 、 将 HITP GET 请 求 映 射 到 读 取 
操作 、 将 HTTP POST 请 求 映射 到 更 新 操作 ， 以 及 将 HTTP DELETE 请 求 映射 到 删除 操作 。 

言 归 正 传 ， 让 我 们 继续 进行 一 些 示例 代码 的 介绍 。 


10.2 ”让 Web API 开始 工作 


从 微软 Visual Studio 中 ， 首 先 你 要 创建 一 个 Web API 类 型 的 ASPNET MVC 项 目 。 你 会 
得 到 一 个 具有 两 个 主要 特征 的 ASPNET MVC 应 用 程序 。 第 一 ，App Start 项 目 文件 夹 包含 一 
个 用 于 Web API 以 设置 特 设 路 由 的 初始 化 程序 组 件 。 第 二 ，Controllers 文件 夹 包含 两 个 示例 
控制 器 类 : 普通 的 HomeController 类 以 及 特定 于 Web API 的 ValuesController 类 。 后 者 继承 自 
ApiController 而 非 Controller。 

这 是 Web API 的 文 柱 。Web API 模块 是 控制 器 类 的 一 个 集合 ， 这 些 控制 器 类 继承 自 预 定 
义 的 ApiController 而 不 是 Controller。 图 10-1 揭示 出 ，Web API 基 础 架构 与 ASPNET MVC 
基础 架构 是 独立 的 ， 不 具有 隐藏 的 依赖 性 。 
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ASPNETMVC 应 
用 程序 原生 端点 


Web API 端点 


图 10-1 Web API 可 通过 不 同 的 应 用 程序 来 托管 并 且 与 ASPNET 并 非 紧密 艳 合 


Web API 模块 是 一 个 独立 的 基于 HITP 的 服务 ， 能 够 被 许多 应 用 程序 托管 ， 而 ASPNET 
MVC 应 用 程序 大 概 是 最 常用 的 宿主 类 型 。 一 个 关键 要 点 是 : 不 要 被 几乎 到 处 出 现 的 
“controller” 一 词 所 蒙 瑞 。 归 根 结 底 , 家 入 由 Web API 驱动 的 HTTP 应 点 集 的 ASPNET MVC 
应 用 程序 使 用 了 普通 的 Controller 类 以 派生 基于 HTML 的 控制 器 ， 并 且 使 用 了 ApiController 
以 派生 返回 要 格式 化 成 JSON 或 XML 的 普通 数据 的 控制 器 类 。 让 我 们 看 看 如 何 构建 一 个 宿 
主 ASPNET MVC 应 用 程序 中 的 Web API 模块 。 


10.2.1 设计 RESTful 接口 


Web API 使 用 了 大 量 的 约定 。 根据 默认 约定 , 产生 的 编程 风格 本 质 上 就 是 RESTful 风格 。 
这 表明 了 与 普通 ASPNET MVC 控制 器 对 应 的 另 一 个 不 同 之 处 ， 普 通 ASPNET MVC 控制 器 
大 多 数 都 是 面向 RPC 的 。 确 切 地 说 ，Web API 完全 不 会 限定 于 RESTful 风格 ; 在 本 章 稍 后 你 
将 看 到 ， 可 以 选择 性 地 赋予 Web API RESTful 风格 或 RPC 风格 。 但 是 ， 默 认 的 并 且 最 受 追 兵 
的 风格 基本 就 是 RESTful。 


1. 定义 资源 类 型 


REST 纯粹 主义 者 主张 (并 且 有 合理 的 理由 )，CRUD 甚至 都 不 是 REST 定义 的 一 部 分 。 
REST 被 定义 为 专注 于 通过 Web 协议 、 特 别 是 HITP 协议 识别 和 处 理 资源 的 一 种 染 构 风格 。 
抽象 理论 和 思想 体系 就 讲 这 么 多 了 ; 但 面临 构建 遭 循 恨 好 REST 原则 的 软件 标准 实现 时 ， 你 
真 的 就 是 要 构建 基于 HITP 的 CRUD。 

无 论 如 何 ，REST 完全 在 于 给 出 资源 的 表示 并 且 在 要 应 用 到 其 他 资源 时 将 服务 器 操作 天 
联 到 通用 的 HITP 动词 。 

在 Web API 的 上 下 文中 , 这 仅仅 意味 着 Web API 模 块 是 一 个 由 许多 控制 器 类 组 成 的 类 库 。 
这 些 控 制 颖 类 继承 日 ApiController, ApiController 是 一 个 在 新 的 System.Web.Http 程序 集中 定 
义 的 类 ， 它 并 非 继 承 自 ASPNET MVC Controller 类 。 当 使 用 默认 RESTful 风格 进行 构建 时 ， 
Web API 控制 器 类 会 公开 一 个 编程 接口 ， 访 接口 要 提供 对 指定 资源 类 型 的 CRUD。 最 有 可 能 
的 情况 是 ， 你 最 终 会 为 倾 问 于 编程 方式 处 理 的 每 个 资源 类 型 使 用 一 个 控制 器 类 。 

资源 类 型 通常 被 定义 为 一 个 普通 数据 传输 对 象 (DTO)， 本 质 上 是 一 个 普通 C# 类 。Visual 
Studio 同 导 为 你 生成 的 示例 Web API 控制 器 类 最 初 不 具有 一 个 真实 的 资源 类 型 。 示 例 控制 器 
仅 会 使 用 普通 字符 串 形式 的 值 。 
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Public class ValuesController : ApiController 


{ 
public IEnumerable<string> Get () 
{ 
return new [|] { "valuel™", "value2™ }; 
| 
public string Get (int 1d) 
{ 
return "value™? 
} 
} 


在 更 实际 的 例子 中 ， 你 可 能 会 想 要 使 用 如 下 定义 的 一 些 News 类 : 


public class News 


{ 
public String Title { get; set; } 
public string Content { get; set; } 
public DateTime Published { get; set; } 
} 


接着 ， 可 以 使 用 一 个 处 理 News 实体 的 控制 器 ， 比 如 以 下 代码 所 示 的 


Public class NewsController : ApiController 


{ 
public IEnumerable<News> GetAll () 
{ 
Var UTL = ...} 
Var client = new WebClient ().; 
Var rss = client.Downloadstring (url); 
Var news = ParseRssInternal (rss);} 
return news; 
} 
public News Get (int index) 
{ 
Var all = GetAll();} 
return all[lindex]; 
} 
} 


Web API 的 执行 指南 


一 个 控制 器 : 


归根 结 底 ，Web API 控制 器 类 是 公共 方法 的 一 个 集合 。 当 不 是 原始 数据 的 时 候 ， 每 个 方 
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法 仅 会 接受 和 返回 DTO。 像 NewsController 这 样 的 普通 类 如 何 才 能 具有 通过 URL 调用 并 返 
回 像 序列 化 成 JSON 或 XML 这 样 的 值 的 方法 呢 ? 这 一 切 都 是 由 于 你 拥有 运行 时 Web API 管 
道 ( 例 如 路 由 ) 并 且 该 任务 是 由 ApiController 类 在 后 台 完 成 才 得 以 实现 。 


2. ApiController 类 


Web API 控制 器 不 返回 视图 : 相反 , 他们 会 回调 用 方 返回 数据 。 调 用 方 就 是 连接 到 HITP 
上 端点 的 任意 客户 端 ;， 例 如 ， 一 个 网 页 、C# 类 或 移动 应 用 。 返 回 值 就 是 Web API 控制 器 与 
ASPNET MVC 控制 器 之 间 最 明显 的 差异 。Web API 中 的 控制 器 基 类 结合 了 ASPNET MVC 
中 操作 调用 程序 和 控制 器 的 行为 。 

第 1 章 “ASPNET MVC 控制 器 ”揭示 出 ， 由 ASPNET MVC 运行 时 所 捕获 的 请 求 会 被 
处 理 成 由 控制 器 名 称 和 操作 名 称 指定 的 一 对 值 。 操 作 调 用 程序 是 负责 获取 控制 器 类 新 实例 的 
系统 组 件 ， 它 会 调用 方法 并 在 结果 之 上 执行 预期 操作 。 在 结果 之 上 执行 操作 实质 上 指 的 是 为 
调用 方 准 备 啊 应 。 通 第 ， 这 涉及 生成 HTML 标记 、 厅 芝 列 化 到 JSON 或 配置 HttpResponse 
ASPNET 对 象 用 于 重 定 问 。 

在 Web API 中 ， 所 有 这 些 任务 都 是 在 ApiController 类 内 部 通过 ExecuteAsync 方法 进行 
协调 的 。 此 外 ， 这 还 意味 着 在 Web API 中 每 个 请 求 都 是 异步 处 理 的 。 不 过 请 注意 ， 这 并 非 完 
全 表示 每 个 由 请 求 所 触发 潜在 长 期 运行 的 任务 都 是 异步 的 。 

ApiController 类 还 能 访问 Web API 环境 的 当前 配置 并 且 恰 如 其 分 地 使 用 该 信息 。 配 置 容 
器 是 新 HttpConfiguration 类 的 一 个 实例 , 它 会 存储 注册 的 用 于 XML 和 JSON 的 格式 化 器 、 路 
由 、 绑 定 规 则 和 师 选 右 的 列表 。 


注意 : 

Web API 基础 架构 ,与 最 值得 注意 的 ApiController 类 及 相关 类 ,都 在 新 的 System.Web.Http 
程 夺 集 中 托管 。 正 如 所 介绍 的 ， 此 程 友 集 不 依赖 于 System.Web 和 System.Web.Mvc。 任 何 听 
起 来 类 似 于 ASPNET MVC 的 概念 (例如 ， 操 作 渍 选 器 、 路 由 、 绕 定 ) 都 是 为 Web API 的 目的 
而 重新 实现 的 。 


3. 路 由 到 操作 方法 


当 Web API 框 架 接收 到 HTTP 请 求 时 , 它 会 根据 操作 方法 将 其 解析 到 控制 器 类 上 的 调用 。 
为 确定 要 调用 的 操作 ， 类 似 于 经 典 ASPNET MVC，Web API 框架 会 使 用 一 个 路 由 表 。 默 认 
项 目 模板 中 的 WebApiConfig 类 包含 了 以 下 默认 路 由 : 
public static void Register (HttpConfiguration config) 
{ 
config.Routes.MapHttpRoute ( 
name: "DefaultAp1i", 
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routeTemplate: "api/{controller}/{1id}", 
defaults: new { 1d = RouteParameter.Optional } 


} 


如 你 所 见 , 由 Web API 识别 的 URL 的 默认 格式 包含 了 紧 随 服务 器 名 称 之 后 的 api 令 牌 以 
及 控制 器 名 称 。 根 据 前 面 提 及 的 NewsController 类 ， 一 个 有 效 的 URL 可 能 是 : 


http://server/api/news/l1 


如 果 上 有 具备 坚实 的 ASPNET MVC 背景 知识 ， 你 就 应 该 马上 会 注意 到 一 个 于 失 的 元 素 : 操 
作 名 称 。 这 就 是 Web API 与 ASPNET MVC 之 间 的 男 一 个 明显 不 同 。 默 认 情况 下 ，Web API 
框架 会 使 用 HTTP 方法 来 选择 操作 而 非 URL。 这 就 是 让 整个 框架 RESTful 化 方面 的 内 容 。 

当 请 求 上 面 的 URL 时 到 底 会 在 NewsController 上 调用 哪个 方法 呢 ? 

要 找 出 该 方法 , Web API 框架 会 查找 与 请 求 的 HTTP 方法 上 的 匹配 。 如 果 通 过 HTTP GET 
方法 进行 请 求 , 则 Web API 会 查找 一 个 名 称 以 Get 开头 的 操作 。 如 前 所 示 ， 在 NewsController 
类 中 ， 有 了 两 个 名 称 以 Get 开头 的 方法 : GetAll 与 Get。 要 选取 哪 一 个 呢 ? 这 取决 于 与 第 3 章 

“模型 绑 定 架构 ”中 讨论 的 ASPNET MVC 绑 定 规则 类 似 的 绑 定 规则 。 

根据 默认 路 由 ， 这 两 个 方法 在 名 称 方面 都 通过 了 测试 。 然 而 ， 由 于 默认 路 由 ， 方 法 可 以 
具有 一 个 可 选 的 名 称 为 id 的 尾随 参数 。GetAll 方法 没有 参数 ， 因 而 代表 着 一 个 良好 匹配 。 相 
反 ，Get 方法 需要 一 个 名 为 index 的 参数 。 由 于 这 个 参数 不 能 在 URL 中 找到 ， 所 以 该 方法 不 
能 匹配 。 


4. 处 理 多 个 匹配 


值得 注意 的 是 ， 方 法 签名 中 小 小 的 变化 就 能 避免 图 10-2 中 描绘 的 异常 。 例 如 ， 将 Get 
方法 的 index 参数 转变 成 一 个 带 有 默认 值 的 参数 ， 如 下 所 示 : 


public News Get (Int index=1) 
{ 


} 
然后 ， 以 下 URL 于 能 同时 由 Get 与 GetAll 匹配 : 
http://server/api/news/l1 


当 出 现 这 种 情况 时 ，Web API 会 在 内 部 抛 出 一 个 异常 ， 并 且 由 调用 方 接收 的 状态 代码 是 
图 10-2 中 所 示 的 带 有 JSON 错误 消息 的 HTTP 500， 该 消息 租 入 在 啊 应 主体 中 。 
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图 10-2 在 多 个 匹配 的 情况 下 返回 的 JSON 和 针 误 消 明 


对 于 操作 名 称 完 全 不 匹配 的 情况 ， 磁 到 多 个 操作 方法 匹配 请 求 的 几率 是 很 高 的 。 如 果 将 
index 参数 重 命名 为 4， 就 像 路 由 中 的 一 样 ， 则 也 会 抛 出 多 个 操作 的 寞 常 。 在 这 种 情况 下 
由 于 id 是 可 选 的 , 所 以 名 称 以 Get 开头 的 带 有 单个 参数 的 任何 方法 都 会 成 为 服务 于 请 求 的 候 
选项 。 


5. 主动 遵循 命名 约定 


所 以 , 看 起 来 你 在 为 操作 方法 寻找 合适 名 称 方面 就 会 很 辛 苗 。 这 恰恰 是 问题 的 关键 所 在 ， 
并 且 该 问题 来 自 于 默认 约定 。 例 如 ， 如 果 是 通过 使 用 HTTP POST 动词 进行 请 求 的 ， 那 么 为 
了 让 请 求 得 以 成 功 处 理 ， 就 应 该 正好 只 有 一 个 名 称 以 Post 开头 的 方法 。 同 样 的 默认 约定 还 需 
要 应 用 到 来 和 目 GET、PUT 与 DELETE 动词 的 请 求 。 


注意 : 
要 避免 一 个 方法 被 作为 操作 调用 ， 你 要 使 用 NonAction 特性 。 这 将 指示 Web API 框架 ， 
即便 该 方法 是 公共 的 并 且 匹 配 路 由 规则 ， 也 不 应 该 将 其 用 作 操 作 方 法 。 


10.2.2 ”预期 的 方法 行为 
Web API 框架 构建 了 一 些 与 每 个 方法 行为 有 关 的 会 匹配 HTTP 动词 的 预期 内 容 。 正 如 你 


己 经 看 到 的 ， 对 于 一 个 HTTP GET 方法 ， 所 需要 的 就 是 该 方法 返回 一 些 友 列 化 .NET 对 象 。 
对 于 其 他 常见 的 HTTP 动词 ， 比 如 PUT、POST 以 及 DELETE， 就 有 一 点 复杂 了 。 


1. POST 方法 的 语义 


POST 方法 通 间 预期 要 将 新 资源 添加 到 一 些 后 台 人 存储 。 其 返回 类型 是 HttpResponseMessage， 
它 表示 一 个 HTTP 响应 消息 并 同时 包括 要 返回 给 调用 方 的 状态 代码 以 及 实际 内 容 。 下 面 是 
POST 方法 常见 的 签名 和 实现 : 

public HttpResponseMessage PostNews (News news,) 

{ 


// Do something here to store the news 
Var newsId = SaveNewsInSomeWay (news); 
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// Build an empty response: 201 1s code for Created 
Var response = Regquest.CreateResponse<Sstring> (HttpStatusCode .Created， 
TORK™) le 


// Store location of the new item 

Var relativePath = String.Format ("/api/news/{0}", newsId); 
response.Headers.Location = new Uri (Request.RequestUri, relativePath); 
return response; 


} 

一 开始 ， 该 方法 应 该 执行 正确 插入 或 保存 任何 接收 到 的 数据 的 任务 。 接 着 ， 它 应 该 设法 
创建 一 个 啊 应 对 象 。 该 状态 代码 应 该 被 设置 为 Created( 如 果实 际 创建 了 新 资源 的 话 ) 并 且 该 内 
容 应 该 是 要 为 调用 方 返 回 的 消息 。 还 建议 将 新 创建 的 项 添加 到 啊 应 标 头 集合 这 一 位 置 。 

2. PUT 方法 的 语义 

PUT 方法 通常 预期 要 更 新 某 后 台 存 储 中 的 一 个 现 有 资源 。 如 果 不 想 要 对 调用 方 共 享有 反馈 
信息 的 话 ， 其 返回 类 型 可 以 为 空 。 不 过 ， 人 合理 地 说 ， 你 应 该 返回 被 设置 为 HTTP 200 或 HTTP 
204 的 HttpResponseMessage 实例 ， 就 如 以 下 代码 一 样 : 


public HttpResponseMessage PutNews (Int32 id, News news) 


{ 
1f (id <= 0) 
throw new HttpResponseException (new HttpResponseMessage 
(HttpstatusCode.NotFound) )}; 
// Do something here to update the news: consider returning HTTP 200 
Var response = Request.CreateResponse<string> (HttpStatuscode .OK，"OK" ) ; 
return response; 
} 


返回 HTTP 204 这 个 状态 代码 也 是 可 以 接受 的 ， 该 状态 代码 表明 ， 请 求 已 经 成 功 处 理 但 
有 意 将 啊 应 设置 为 宇 。 要 选择 的 HttpStatusCode 值 是 NoContent。 

3. DELETE 方法 的 语义 

DELETE 方法 通常 预期 要 删除 某 后 台 存 储 中 的 一 个 现 有 资源 。 请 记 住 虚 方 法 是 可 行 的 ， 
但 正如 以 下 代码 中 所 示 的 ,你 的 目标 应 该 是 返回 HTTP 200 或 HITP 204。 在 这 种 情况 下 ,HTTP 
200 或 204 将 被 解 谈 为 资源 已 经 成 功 删 除 的 证 明 。 


public HttpResponseMessage DeleteNews (Int32 1d) 
{ 
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if (1d <= 0) 
throw new HttpResponseException (new HttpResponseMessade 
(HttpstatusCode.NotFound) )}; 


// Do something here to delete the news 


return new HttpResponseMessage (HttpstatusCode.NoContent); // 204 
} 


对 于 一 个 DELETE 请 求 ， 你 还 可 以 选择 返回 状态 代码 HTTP 202， 它 表明 请 求 已 被 服务 
器 接受 并 且 资 源 已 被 标记 为 删除 。 重要 的 一 点 是 , 这 不 能 让 调用 方 确定 资源 是 否 被 真正 移 除 ， 
但 同时 它 能 够 避免 服务 器 承担 删除 的 职责 。 

4. 其 他 方法 的 语义 

义 秆 GET、PUT、POST 与 DELETE 是 最 常用 的 HTTP 动词 ， 但 可 行 的 HITP 动词 列表 
并 非 只 包含 这 四 人 个。 不过， 从 Web API 的 角度 讲 ， 除 了 以 上 4 个 HTTP 动词 之 外 ， 其 他 合理 
的 动词 并 不 会 被 框架 特别 处 理 。 这 意味 着 没有 约定 能 够 应 用 于 它们 。 看 看 如 下 代码 : 


public HttpResponseMessage HeadNews (Int 1d) 


{ 
Var message = new HttpResponseMessage (HttpstatusCode .orR); 
message.Headers.Add ("NewsId", ld.ToSstring()); 
return message; 

} 


根据 万 维 网 联盟 (W3C) 的 表述 ，HEAD 请 求 预 期 要 像 GET 那样 运行 ， 不同 之 处 在 于 其 啊 
应 主体 为 空 并 且 只 会 返回 啊 应 标 头 。 

但 是 , 前 面 的 代码 并 不 会 运行 且 会 产生 一 个 HITP 404。 原因 是 我 们 讨论 的 适用 于 最 常用 
动词 的 命名 约定 并 不 能 应 用 到 此 人 处。 如果 想 要 该 方法 为 传 入 HTTP HEAD 的 请 求 运行 ， 应 该 
使 用 AcceptVerbs 特性 。 

[AcceptVerbs ("HEAD")| 


public HttpResponseMessage HeadNews (int 1d) 

{ 

} 

再 次 注意 ，AcceptVerbs 具有 与 ASPNET MVC 特性 相同 的 名 称 和 行为 , 但 它 是 在 一 个 不 
同 的 程序 集中 定义 的 。 归 根 结 确 ， 它 是 一 个 完全 个 同 的 类 ， 但 具有 相同 名 称 和 大 部 分 相同 的 
行为 。 
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10.2.3 使 用 Web API 


构建 在 一 个 ASPNET MVC 应 用 程序 内 部 的 Web API 模块 是 由 该 ASPNET MVC 应 用 程 
序 托管 的 。 要 使 用 Web API 模块 ， 你 只 需要 使 用 ASPNET MVC 站 点 即 可 。 在 这 一 点 上 ， 你 
所 看 见 的 都 是 你 用 已 有 API 能 够 使 用 的 HITP 端点 ， 其 中 包括 一 个 基于 JavaScript 的 API。 


1. 从 JavaScript 调用 Web API 


从 Web 客户 站 内 部 ，Web API 前 疹 承 是 一 个 简单 的 HITP 交点 集合 。 可 以 使 用 jQuery 
工具 来 放置 HTTP 调用 , 或 者 使 用 KnockoutJS 工具 来 呈现 出 对 象 集合 。 以 下 是 你 需要 用 来 设 
置 Web API 远程 数据 绑 定 的 代码 (这 是 一 个 .cshtml 视图 文件 的 摘要 ): 


<hl>Web API DEMO</hl1> 
<script type="text/Javascript"> 
function News (title) 1 
this.title = title; 
} 
function NewsViewModel (11stOfNews) { 
this.allNews = listOfNews; 
} 
</script> 
<Script type="text/Javascript"> 
$ (document) .ready (function () ({ 
getNews (function (listofNews) { 
ko.applyBindings (new NewsViewModel (li1stOofNews)); 
}); 
}); 


function getNews (callback) 1 
$.a]aX({ 
url: "“/api/news/all™., 
Lyvpes “GET”， 
statusCode: 1 
200: function (listOfNews) { callback (1i1stofNews}); }, 
404: function () { alert ("No news found!"); } 
} 
}); 
} 
</script> 


<dlVv ld="news—container™"> 


<h2>Late breaking tennis news</h2> 
<table> 
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<thead><tr> 
<th>Title</th> 

</tr></thead> 

<tbody data-bind="foreach: allNews"> 
<Lr> 

<td data—bind="text: Title"></td> 

</tr> 

</tbody> 

</table> 
</d1liv> 


10-3 显示 了 了 最终 的 结果 。 


Web API DEMO 


Late breaking tennis news 


Title 
Tsonga Stuns Federer To Keep French Dream Alive 
LlodraMahut Upset Granollers/Lopez To Reach Semis 
Ferrer Sweeps Past Robredo Into Second Straight Roland (yarros SF 
Nadal On Federer Rivalry: Fashion Police Quiz Haas 
Wawrmka Fights Past Gasquet, Next Meets Nadal In First Pars QF 


图 10-3 ”使 用 Web API 下 载 最 新 的 网 球 新 闻 


$.ajax jQuery 工具 让 你 能 够 指定 HITP 动词 和 标 头 。 这 样 一 来 ， 你 融 能 够 轻易 地 作 好 调 
用 Web API 后 决 上 的 任意 类 型 操作 的 调用 准备 。 


2. 从 服务 器 靖 代 码 调用 
由 于 Web API 模块 是 一 个 普通 的 HTTP 前 端 ， 因 此 从 一 些 .NET 服务 器 端 代 码 内 部 调用 


它 就 与 从 任何 其 他 类 型 的 远程 端点 调用 没什么 区 别 。 从 ASPNET MVC 应 用 程序 内 部 ， 可 以 
使 用 控制 器 方法 来 生成 HTML， 如 下 所 示 : 


public ActionResult News () 
{ 
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Var Client = new WebClLlient() :; 


Var Content = client.Downloadstring("/api/news"); 
Var Serlallzer = new JavaSscriptSsSerializer(); 
Var listOfNews = serializer.Deserialize<IList<News>> (Content) ; 


return View(11stofNews) ，; 


} 


该 代码 会 将 数据 作为 JSON 下 载 ， 然 后 使 用 JavaScriptSerializer 类 将 其 转换 到 一 个 .NET 
对 象 中 一 具体 来 说 ， 是 一 个 News 数据 对 象 列 表 。 该 列表 随后 会 作为 视图 模型 传递 给 视图 
引擎 以 通过 Razor 生成 用 户 界 面 。 


QQmodel ILILst<SImplest.Models.Dto.News> 
<hl>Web API DEMO</h1> 


<d1V lid="news—container"> 
<h2>Late breaking tennis news</h2> 
<table> 
<thead><tr> 
<th>Title</th> 
</tr></thead> 
<tbody> 
@foreach (var n in Model) 
{ 
<tr> 
<td>@n.Title</td> 
</tr> 
} 
</tbody> 
</table> 
</dliv> 


上 述 的 代码 使 用 了 最 简单 (但 却 非常 有 效 ) 的 下 载 和 转换 JSON 数据 的 方法 。 在 最 新 版 本 
的 .NET 框架 中 ， 可 以 使 用 其 他 内 置 的 JSON 转换 器 或 HTTP 客户 端 类 ， 它 们 提供 了 对 异步 调 
用 的 更 好 支持 。 但 是 最 终 ， 无 论 使 用 何 种 特定 工具 或 技术 ， 其 目的 都 是 下 载 JSON 数据 并 将 


3. 进行 异步 调用 


我 们 都 知道 编写 的 代码 必须 总 是 高 上 度 可 扩展 的 。 现 在 ， 我 可 以 慨 意 地 承认 ， 没 有 任何 代 
码 存 在 于 高 度 可 扩展 应 用 程序 的 上 下 文中 。 然 而 ， 当 面临 为 可 扩展 性 重 构 时 ， 在 读 取 和 写 入 
方面 有 两 件 基 本 的 事情 可 以 完成 : 使 用 缓存 和 异步 逻辑 。 长 时 间 以 来 , 在 .NET 语言 中 编写 异 
步 代 码 都 很 麻烦 。 但 是 ， 从 C# 5.0 和 .NET Framework 4.5 开始 ， 像 async/await 这 样 的 新 关键 
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字 通 过 添加 少许 语法 使 得 这 项 任务 变 得 简单 了 。 

这 样 一 来 ， 虽 然 我 仍然 不 认为 出 于 我 们 都 需要 可 扩展 性 的 原因 ， 所 有 的 远程 调用 都 必须 
是 异步 的 ， 但 我 也 没 发 现 特殊 的 原因 不 去 编写 带 有 async/await 关键 字 的 异步 远程 调用 ， 这 些 
调用 使 得 我 们 可 以 避免 无 阻塞 调用 (特别 是 来 自用 户 界面 的 ) 并 且 仍 能 设法 保持 代码 的 高 可 读 
性 。 下 面 是 如 何 通 过 使 用 async/await 语言 工具 重 写 Web API 方法 的 代码 : 


public async Task<IList<News>> GetAll1() 


{ 
Var url = ...}? 
Var client = new HttpClient () ; 
Var Tss = awalt client.GetstringAsync (url); 
Var news = ParseRssIlInternal (rss); 
return news; 
} 


作为 使 用 WebClient 进行 远程 调用 的 替代 选项 ， 可 以 使 用 最 新 的 HttpClient， 它 是 老式 可 
靠 的 WebClient 客户 端的 修改 及 更 丰富 的 版 本 。HttpClient 是 在 System.Net.Http 名 称 空 间 中 定 
义 的 。 

ASPNET MVC 方法 负责 调用 使 用 以 下 代码 进行 异步 编码 的 Web API 模块 . 


public async Task<ActionResult> News () 


{ 
var feed = new FeedController(); 
Var model = awalt feed.GetA]ll():; 
return View (model); 

} 


从 JavaScript 调用 一 个 异步 编码 的 Web API 模块 不 需要 对 客户 端 代码 作 任 何 修改 。 
10.2.4 ”设计 面向 RPC 的 接口 

到 目前 为 止 ， 基 于 RESTful 能 够 解决 公共 API 定义 问题 的 假设 ， 我 们 已 经 尝试 了 使 用 
Web API。 总 的 来 说 ， 对 于 ASPNET MVC 的 开发 人 员 ， 正 确 地 看 待 Web API 是 最 困难 的 事 
情 。Web API 看 起 来 与 你 已 经 习惯 的 普通 控制 器 类 似 ， 并 且 轻 率 地 将 其 归结 为 又 一 种 奇怪 类 
型 的 控制 器 的 误解 还 是 很 多 的 。 

Web API 就 是 你 业务 领域 的 SDK:; 如 果 用 在 ASPNET MVC 应 用 程序 中 ， 它 就 是 你 应 用 
程序 要 基于 的 SDK。 但 是 同时 ， 此 SDK 是 通过 HTTP 来 进行 公共 公开 的 。 


1. HTTP 上 的 CRUD 只 是 选项 之 一 


API 上 默认 局 用 的 约定 倾 问 于 让 开发 人 员 从 HTTP 上 CRUD 的 上 下 文 角度 来 看 待 API。 
可 以 定义 一 个 模型 对 象 并 构建 一 个 API 控制 器 来 在 其 上 运行 。API 方法 是 根据 对 指定 资源 执 
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行 基 本 操作 的 基础 HITP 动词 来 建 模 的 。 这 就 为 设计 提供 了 RESTful 化 (RESTfulness) 的 风格 。 

正如 之 前 所 看 见 的 ， 此 方式 也 会 造成 命名 冲突 ， 因 为 你 会 发 现 很 难 对 一 个 返回 遵循 非常 
规 结构 的 数据 的 方法 命名 。 这 种 RESTful 方式 并 非 唯一 可 行 的 方式 : 向 同 RPC 的 方式 也 可 行 。 

很 难说 REST 是 否 优 于 了 PC。 但 我 认为 应 用 程序 的 最 大 责任 束 是 面 同 RPC。 例 如 ， 大 多 
数 ASPNET MVC 站 点 都 是 建 在 方法 集 上 的 , 这 些 方法 只 能 通过 GET 或 POST 调用 .实际 上 ， 
ASPNET MVC 刚 推出 的 几 年 里 ， 许 多 个 人 项 目 就 已 经 开始 让 ASPNET MVC 表现 出 明显 的 
RESTful 化 风格 了 。 

不 过 ， 最 后 的 解决 方式 很 简单 : 无 论 Visual Studio 中 Web API 项 目的 默认 约定 是 什么 ， 
你 都 可 以 获得 API 的 完全 控制 ， 并 且 如 果 喜 欢 的 话 ， 可 以 赋予 其 RPC 风格 。 


2. 操作 特性 


将 Web API 的 设计 转变 成 RPC 的 关键 是 使 用 操作 特性 。 与 你 在 ASPNET MVC 控制 器 中 
所 做 的 非常 类 似 ， 可 以 使 用 像 HttpGet、HttpPost、HttpPut 或 HttpDelete 这 样 的 特性 来 标记 
Web API 方 法 ， 这 样 一 来 ， 不 管 名 称 是 什么 ， 都 可 以 考虑 使 用 这 些 特性 ， 只 要 请 求 动词 可 以 
匹配 某 特 性 即 可 。 

[HttpGet] 


public IEnumerable<News> All() 
{ 


} 

All 方法 现在 可 以 用 于 GET 请 求 ， 即 便 其 名 称 并 非 以 Get 开头 。Web API 库 提 供 了 预定 
义 的 特性 ， 比 如 HttpGet、HttpPost、HttpPut 或 HttpDelete， 就 像 AcceptVerbs 一 样 可 以 用 来 
将 一 个 或 多 个 HTTP 动词 绑 定 到 方法 。 

3. 自 定 义 路 由 

仅仅 使 用 操作 特性 不 足以 让 你 获得 API 的 全 面 控制 。 你 可 能 还 需要 修改 在 Visual Studio 
问 导 为 你 创建 的 初始 标准 Web API 项 目 中 定义 的 默认 路 由 。 默 认 路 由 并 不 具有 用 于 操作 名 称 
的 占 位 符 。 你 可 能 会 想 要 将 之 前 在 “路 由 到 操作 方法 ”一 节 中 讨论 过 的 DefaultApi 路 由 蔡 换 
成 下 夯 这 样 : 

RouteTable.Routes .MapHttpRoute ( 

name: "RpcRoute™, 


routeTemplate: "api/{controller}/{action}/{1d}", 
defaults: new { 1d = RouteParameter.Optional }); 


主要 的 区 别 是 ， 现在 路 由 为 方法 名 称 保留 了 一 个 占 位 符 一 一 {action} 占 位 从 。 这 使 得 处 理 
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请 求 到 方法 的 过 程 几 乎 与 ASPNET MVC 普通 控制 器 相同 ， 除 了 该 URL 中 额外 的 api 这 几 
| 本 。 
http://server/api/news/all 


上 面 的 URL 将 在 RESTful 模型 中 产生 一 个 异常 ， 但 将 All 方法 上 的 HttpGet 与 定义 的 自 
定义 RpcRoute 路 由 结合 使 用 ， 它 就 能 正常 运行 了 了 。 


4. 特性 路 由 


Web API 的 大 部 分 设计 都 归功 于 ASPNETMVC, 即 使 它 与 ASPNET MVC 运行 时 完全 没 
有 联系 。 在 随 Visual Studio 2013 和 ASPNET MVC 5 同时 到 来 的 Web API 的 最 新 版 本 中 ， 你 
会 发 现 一 个 称 为 特性 路 由 的 功能 ， 它 在 ASPNET MVC 没有 直接 对 应 项 ， 相 反 ， 它 派生 于 过 
时 的 WCF Web HTTP 绑 定 。 

经 典 的 路 由 是 基于 约定 的 。 当 一 个 请 求 传 入 时 ， 会 针对 global.asax 中 注册 的 路 由 模板 来 
匹配 URL。 如 果 匹 配 成 功 ， 则 为 请 求 提 供 服务 的 合适 控制 匿 与 操作 方法 就 能 从 模板 中 确定 。 
如 果 匹 配 不 成 功 ， 则 请 求 将 被 拒绝 并 且 其 结果 通常 是 一 个 HITP 404 消 轧 。 路 由 匹配 只 会 基 
于 首次 匹配 生效 。 首 次 匹配 的 最 直接 后 果 就 是 ， 路 由 注册 的 顺序 很 重要 。 大 多 数 特定 路 由 应 
该 出 现在 列表 前 面 ; 沱 统 及 最 通用 的 路 由 应 该 位 于 列表 了 最 后 。 这 样 伏 的 重大 意义 何在 呢 ? 

在 具有 强烈 REST 风格 的 中 型 应 用 程序 中 已 存在 的 路 由 数量 可 能 会 非常 多 ， 轻 易 就 能 达 
到 数 以 百 计 。 要 确定 超过 200 个 路 由 的 正确 顺序 肯定 会 变 得 非常 困难 ， 而 且 你 会 陷入 围绕 在 
目 动 化 测试 期 间 检 测 到 的 或 者 由 用 户 和 测试 人 员 通 报 的 回归 周围 的 无 穷 循环 之 中 。 特 性 路 由 
提供 了 一 种 顺畅 方式 来 处 理 这 种 情况 中 的 路 由 。 

顾名思义 ， 特 性 路 由 就 是 让 路 由 (作为 特性 ) 附 加 到 特定 操作 方法 ， 如 以 下 代码 所 示 : 

[HttpGet ("orders/{orderId}/show")] 

public Order GetorderBYId (Int orderId) 

{ 


} 

上 述 代码 片段 表明 ,只 要 请 求 URL 模板 匹配 指定 模式 ,GetOrderById 方法 就 可 通过 HTTP 
GET 进行 调用 。 路 由 参数 一 一 orderId 令 牌 一 一 必须 匹配 在 方法 签名 中 定义 的 一 个 参数 。 还 有 
另外 一 些 详细 信息 需要 讨论 ， 但 特性 路 由 的 要 点 都 已 在 这 里 作 过 介绍 了 。 不 可 否认 ， 特 性 路 
由 与 现在 已 过 时 的 WCF Web HITP 编程 模型 尤其 是 WebGet 特性 非常 类 似 。 


[WebGet (UriTemplate="orders/{1id}/show")] 
Order GetOrderById(int 1d); 
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5. 开局 特性 路 由 


默认 情况 下 特性 路 由 没有 开启 ， 但 它 可 以 与 常规 路 由 同时 运行 。 下 面 是 开启 它 的 标准 
方法 : 


public static class WebApiConfig 


{ 
public static void Setup (HttpConfiguration conf1ig) 
{ 
config.MapHttpAttributeRoutes ()} 
} 
} 


如 果 打 算 将 这 两 种 类 型 的 路 由 一 起 使 用 ， 建 议 你 优先 使 用 特性 路 由 。 这 意味 着 你 要 在 开 
始 将 全 局 路 由 汐 加 到 系统 前 调用 MapHttpAttributeRoutes。 

可 以 通过 特性 为 每 个 方法 定义 一 个 想 要 的 路 由 ， 并 且 还 可 以 为 用 于 调用 操作 的 HITP 方 
法 定义 和 蔓 选 器 。 在 Web API 中 ， 像 HttpGet、HttpPost、HttpDelete、HttpPut 这 样 以 及 所 有 其 
他 的 特性 类 都 已 经 用 一 个 重 载 扩 展 了 ， 以 便 接 收 路 由 URL 模板 。 如 果 愿 意 ， 还 可 以 使 用 
AcceptVerbs 特性 ， 其 第 一 个 参数 表示 方法 名 称 ， 而 第 二 个 参数 设置 路 由 ， 如 下 所 示 : 

[AcceptVerbs ("GET", "orders/{1d}/show")] 

尔 还 可 以 将 AcceptVerbs 用 于 不 受 文 持 的 HITP 方法 或 者 WebDAV 方法 。 

特性 路 由 还 可 以 使 用 与 经 典 路 由 稍 许 不 同 的 语法 来 文 持 参 数 约束 。 该 API 具有 一 个 预定 
义 的 约束 列表 ， 比 如 int、bool、alpha、min、max、length、minlength 以 及 range。 这 里 显示 
了 如 何 使 用 它们 : 

[HttpGet ("orders/{1id:1int}/show") 

约束 的 目的 显而易见 。 要 了 解 更 多 详细 信息 ， 可 以 得 隐 http://www.asp.net/web-ap1/ 
overview/web-api-routing-and-actions/attribute-routine-in-web-api-2 处 的 一 些 文 档 。 

可 以 随 你 所 愿 将 许多 约束 串联 使 用 ， 也 可 以 创建 自 定义 约束 。 

[HttpGet ("orders/{1id:int:range(l1l, 100)}/show"] 

要 创建 一 个 上 自 定 义 约 束 ， 需 要 创建 一 个 实现 IHttpRouteConstraint 接口 的 类 并 使 用 以 下 代 
人 码 来 注册 它 : 


var resolver = new DefaultInlineConstraintResolver (); 
resolver.ConstraintMap.Add ("custom", typeof (YourCustomConstraint)); 
config.MapHttpAttributeRoutes (new HttpRouteBuilder (resolver)); 


IHttpRouteConstralnt 接口 只 有 一 个 名 为 Match 的 方法 。 
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10.2.5 ”安全 性 考量 


总 体 上 , Web 应 用 程序 的 安全 控制 要 比 Web API 模块 的 安全 控制 简单 , 这 只 有 一 个 原因 : 
要 考虑 的 情况 较 少 。 由 于 ASPNET MVC 应 用 程序 是 针对 最 终 用 户 的 ， 因 此 很 大 程度 上 ， 安 
全 性 指 的 是 对 用 户 进 行 喘 份 验 证 并 确保 每 个 已 验证 用 户 都 有 权限 执行 指定 操作 。 

表单 验证 (例如 ， 在 其 中 输入 凭据 的 登录 窗口 ) 是 最 常用 的 捕获 和 验证 凭据 的 方式 。 在 
ASPNET MVC 中 , 操作 方法 上 的 Authorize 特性 会 指示 运行 时 只 有 已 验证 用 户 才能 调用 该 方 
法 。Authorize 特性 上 的 参数 或 该 方法 实现 中 的 普通 代码 随后 将 执行 更 为 复杂 的 检查 ， 以 判定 
分 配给 指定 登录 用 户 的 角色 。ASPNET MVC 应 用 程序 安全 性 方面 的 内 容 在 第 6 章 “ 应 用 程 
序 安全 性 ”中 已 作 过 详细 介绍 。 

谈 及 Web API 时 ， 还 有 一 些 额 外 的 场景 需要 注意 。Web API 模块 就 是 一 个 API， 可 以 为 
第 三 方 开发 人 员 的 使 用 而 编写 它 。 那 么 你 要 如 何 控制 该 客户 端 是 已 知 并 通过 授权 的 呢 ? 


1. 宿主 要 负责 处 理 安全 性 


Web API 模块 面临 的 最 简单 但 并 非 最 常见 的 场景 是 ，API 和 答 主 都 由 同一 个 团队 省 理 。 在 
这 种 情形 下 ， 和 宿主 要 负责 对 用 户 进行 身份 验证 并 且 避 人 免 出 现任 何 可 能 的 调用 API 的 用 户 界面 。 
因此 ，Web API 会 假设 所 有 身份 验证 都 发 生 在 宿主 内 ， 例如， 在 IIS 内 部 通过 HTTP 模 
块 对 内 置 模块 或 目 定 义 模块 进行 身份 验证 。 为 了 应 对 这 种 情况 ， 需 要 在 API 控制 器 类 或 单独 
方法 上 使 用 Authorize 特性 。 这 与 在 普通 ASPNET MVC 应 用 程序 中 面 对 的 情况 几乎 相同 。 
[Authorizel] 


public IList<News> GetAll () 
{ 


} 

注意 这 里 使 用 的 AuthorizeAttribute 类 与 ASPNET MVC 中 使 用 的 AuthorizeAttribute 不 同 。 
虽然 编程 接口 相同 ， 但 这 个 类 是 在 另外 的 位 置 定义 的 ， 以 避免 对 ASPNET 运行 时 的 依赖 。 

你 还 可 以 将 Authorize 特性 设置 成 全 局 的 ， 以 便 它 能 应 用 于 所 有 API 控制 器 的 所 有 方法 。 
如 果 打 算 这 样 做 ， 请 使 用 以 下 代码 : 

public static SetupAuthorization (HttpConfiguration conflig) 

{ 

config.Filters.Add (new AuthorizeAttribute()); 

} 

请 牢记 ， 在 这 种 情况 下 所 有 的 方法 都 是 要 进行 安全 控制 的 对 象 ; 不 过 ，AllowAnonymous 
特性 会 让 你 为 匿名 调用 保留 一 个 可 用 方法 。 


public class NewsController : ApiController 
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{ 

[AllowAnonymous | 

public IList<News> GetAll1() { ... } 

public HttpResponseMessage PostNews (News news) { ... } 
} 


在 方法 主体 中 进行 身份 验证 之 后 ， 可 以 使 用 ApiController 类 上 的 User 属性 来 检查 详细 
信息 以 及 用 户 的 角色 ， 并 且 如 果 未 通过 检查 就 拒绝 该 调用 。 


2. 使 用 基本 身份 验证 


在 宿主 为 身份 验证 和 授权 规则 提供 的 方案 之 外 ， 就 是 在 Web API 模块 中 集成 安全 层 。 最 
简单 的 方式 是 使 用 构建 在 Web 服务 器 中 的 基本 上 身份 验证 。 基本 号 份 验证 是 基于 用 户 任 据 封 痰 
在 每 一 个 请 求 中 这 一 思想 的 。 

基本 喘 份 验证 有 其 优 缺 点 。 从 优点 方面 来 说 ， 它 文 持 主流 浏览 句 ; 它 是 一 项 互联 网 标准 ; 
它 易 于 配置 。 其 缺点 是 ， 赁 据 是 随 每 个 请 求 发 送 的 ， 并 且 更 糟 的 是 ， 它 们 都 是 以 明文 发 送 的 。 

基本 号 份 验证 预期 凭据 会 被 发 送 到 服务 器 上 验证 。 随后 当 和 凭据 是 有 效 时 , 请求 会 被 接受 。 
如 果 请 求 中 没有 凭据 ， 就 会 显示 一 个 交互 式 对 话 框 。 实 际 上 ， 基 本 喘 份 验证 还 需要 一 个 自 定 
义 HTTP 模块 来 根据 存储 在 某 目 定义 数据 库 中 的 账户 检查 凭据 。 


注意 : 
将 基本 身份 验证 与 一 个 执行 自 定义 凭据 验证 的 层 结合 起 来 使 用 是 简单 且 十 分 有 效 的 。 要 
克服 凭据 作为 明文 发 送 这 一 限制 ， 你 应 该 总 是 在 HTTPS 上 实现 基本 身份 验证 解决 方案 . 


3. 使 用 访问 令 牌 


此 处 的 思想 是 ，Web API 会 接收 一 个 访问 令 牧 ( 通 音 是 一 个 GUID 或 一 个 字母 数字 字符 
串 )、 验 证 它 、 并 在 该 令 牌 未 过 期 且 对 应 用 程序 有 效 时 为 请 求 提 供 服务 。 有 各 种 方式 和 不 同 的 
安全 解决 方案 来 向 及 令 牌 。 

令 牌 的 最 简单 方案 是 ， 当 客户 联系 你 要 使 用 你 的 API 时 在 线 下 颁发 令 脾 。 你 要 创建 令 牌 
并 将 其 关联 到 特定 客户 。 此 后 ， 该 客户 就 要 对 小 用 或 错 用 API 负责 。 

Web API 后 端 需要 有 一 个 检查 令 牌 的 层 。 可 以 将 这 个 层 作为 普通 代码 添加 到 任意 方法 ， 
或 更 好 的 是 ， 将 其 配置 成 一 个 消息 处 理 程序 。 在 Web API 中 ， 一 个 消息 处 理 程 序 就 是 一 个 组 
件 ， 该 组 件 会 检查 HTTP 请 求 并 设置 该 请 求 上 的 主体 ， 以 便 ApiController 上 的 User 属性 能 
被 正确 填充 。 


注意 : 


类 似 于 ASPNET 的 HTTP 处 理 程 序 ， 消 息 处 理 程序 仅 会 应 用 于 通 向 Web API 的 通信 流 。 
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可 以 在 http://www.asp.net/web-api/overview/working-with-http/http-message-handlers 阅读 到 更 
多 内 容 。 


4. 使 用 OAuth 


一 个 更 加 复杂 的 方案 是 使 用 OAuth 身份 验证 来 限制 对 Web API 模块 的 访问 。 第 6 章 讨论 
了 了 如何 将 OAuth 与 Facebook 或 Twitter 结合 起 来 使 用 以 对 站 点 的 用 户 进 行 刁 份 验证 。 这 里 的 
关键 在 于 ， 将 你 的 Web API 模块 转变 成 OAuth 服务 器 ， 类 似 于 Twitter 或 Facebook 所 做 的 。 

归根 结 感 ，OAnuth 就 是 之 前 讨论 过 的 令 牌 方案 的 一 种 形式 。 不 同 之 处 是 ， 你 需要 使 用 一 
个 不 同 的 组 件 来 在 检查 了 用 户 的 凭据 之 后 在 线 贫 发 令 牌 。 授 权 服 务 器 介 于 受 保护 资源 (Web 
APD 和 潜在 客户 之 间 。 图 10-4 显示 了 典型 OAuth 会 话 的 布局 。 


图 10-4 ”客户 端 与 Web API 服 务 器 之 间 典 型 的 OAuth 握手 


你 要 如 何在 实践 中 对 其 编码 呢 ? 

这 很 大 程度 上 取决 于 你 , 但 它 很 可 能 需要 使 用 Web 后 端 以 用 作 授权 服务 器 。 它 将 根据 由 
已 验证 用 户 提 供 的 凭据 (比如 Facebook 提供 的 ) 来 负责 颁发 令 牌 。 接 着 ， 你 要 使 用 Web API 层 
tp tr de phe tend 在 该 消息 处 理 程序 中 ， 你 还 
可 以 引入 任意 的 机 制 来 以 你 认为 有 意义 的 方 方式 包括 过 期 、 误 用 、 

或 因为 调用 方 的 调用 超出 了 分 配 配额。 


使 用 跨 源 资源 共享 


路 源 资源 共享 (CORS) 是 一 个 W3C 标准 , 它 定 义 了 想 要 对 不 同 域 进行 Ajax 请 求 的 网 页 
为 。CORS 放宽 了 所 有 浏览 器 都 实现 的 同 源 策略 ， epee estate tid 
和 面 所 在 的 单个 域 中 进行 。 

注意 : 

浏览 器 实现 了 同 源 策 略 并 出 于 安全 原因 会 阻止 跨 域 Ajax 调用 。 因 此 ，CORS 是 否 就 是 一 
种 值得 信赖 的 方式 呢 ?” 或 者 ， 它 不 会 前 弱 安 全 性 吗 ? 无 论 目 标 站 点 是 否 允 许 接 受 跨 域 调 用 ， 
浏览 器 的 同 源 策略 都 会 限制 客户 端 页 面 进 行 任何 跨 域 调用 . CORS 规范 只 是 定义 了 一 个 协议 ， 
通过 该 协议 ， 站 点 就 能 允许 接收 来 自 远 程 站 点 的 调用 。CORS 不 会 削弱 安全 性 ， 这 是 因为 跨 
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域 调用 会 查找 双方 是 否 都 允许 此 类 调用 。 

你 需要 通过 一 个 新 的 名 称 为 EnableCors 的 特性 来 启用 CORS。 可 以 像 方 法 一 样 在 控制 器 
上 设置 该 特性 。 要 让 该 特性 生效 ， 你 还 需要 调用 global.asax 中 HttpConfiguration 对 象 上 的 
EnableCors 方法 。 


usSing System.Web.Http.Cors; 
public static class WebApiConf1ig 


{ 
public static void Register (HttpConfiguration config) 
{ 
config.EnableCors () ; 
} 
} 


你 要 将 新 创建 的 EnableCorsAttribute 类 的 实例 传递 到 你 得 到 的 方法 以 便 为 所 有 方法 和 所 
有 控制 器 全 局 开启 CORS。 如 果 使 用 在 控制 器 级 别 开 启 的 CORS 并 想 要 在 一 个 特定 方法 上 关 
闭 它 ， 只 需要 使 用 DisableCors 特性 即 可 。 


10.3 协商 响应 格式 


在 你 使 用 示例 NewsController 类 进行 一 些 实 践 之 后 ， 你 大 概 会 注意 到 ， 默 认 情 况 下 所 有 
操作 方法 都 会 返回 其 序列 化 为 JSON 字符 串 的 数据 。 这 正 是 大 多 数 时候 开 发 人 员 想 要 的 ， 但 
它 并 不 适合 于 所 有 可 能 的 情形 .实际 上 ,有 时 候 你 还 会 想 要 通过 XML、 普 通 文本 或 者 iCalendar 
源 ( 这 当然 可 行 ) 来 公开 相同 的 数据 。 这 十 侣 意味 看 你 需要 为 每 个 可 行 的 输出 格式 使 用 多 个 操 
作 方 法 呢 ? 这 正 是 Web API 中 内 容 协 商 所 适用 之 处 。 


10.3.1 ASPNET MVC 方式 

在 经 典 的 ASPNET MVC 中 ， 可 以 通过 在 每 个 操作 方法 中 手动 强制 进行 有 序 分 离 来 处 理 
这 一 问题 ， 该 有 序 分 离 介 于 产生 要 返回 的 原始 数据 的 代码 和 以 适合 调用 方 的 方式 格式 化 原始 
数据 的 代码 之 间 。 

1. 理解 请 求 格式 

首先 ， 在 调用 方 能 够 指定 预期 的 输出 格式 方面 ，ASPNET MVC 并 不 具有 默认 和 明确 定 
义 的 方法 。 一 个 广泛 接受 的 解决 方案 包括 ， 使 用 一 个 查询 字符 串 ( 或 特 设 路 由 ) 中 的 参数 ， 该 
参数 会 将 所 选 的 啊 应 格式 市 入 控制 器 代码 内 部 。 这 里 是 我 最 豆 欢 的 结构 : 


Public ActionResult All (Boolean xml = false) 
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// Get raw data 
Var listOfNews = NewsHelper.GetAllNews (); 


// Serialize raw data 
1f (xml]l) 

return new NewsXxXmlFormatter() .Serialize (11stOfNews):; 
return Json (listOfNews, JsonRequestBehavior.AllowGet);} 

} 

这 意味 着 ， 通 过 将 xml=true 添加 到 URL 的 查询 字符 串 ， 你 就 能 让 数据 作为 XML 返回 。 
否则 ， 你 将 得 到 作为 JSON 人 返回 的 数据 。 对 于 以 XML 架构 格式 化 数据 来 说 ， 根 据 所 处 环境 
不 同 ， 我 会 借助 于 一 个 通用 的 XML 格式 化 器 或 者 一 个 特定 对 象 的 特定 格式 化 器 。 

如 果 不 喜 欢 使 用 参数 ， 则 可 以 选择 一 个 特 设 的 路 由 ， 比 如 以 下 这 个 : 

routes .MapRoute 

name: "Xxml™, 

url: "xml/{controller}/{actijon}/{1d}", 

defaults: new { controller = "Home™, action = "Index™", id = 
UrlParameter.Optional, xml = true } 

) : 

更 普 裔 的 情况 是 ， 找 出 一 种 方式 得 到 预期 的 啊 应 格式 ， 这 项 任务 取决 于 开发 人 员 。 使 用 
路 由 或 参数 都 只 是 可 行 的 方法 而 已 。 可 以 要 求 调 用 方 添加 一 个 特定 的 HITP 标 头 ， 或 者 可 以 
检查 一 些 默认 的 HITP 标 头 ， 比 如 Accept 或 Content-Type。 


2. 强制 将 数据 与 格式 分 离 

正如 可 以 从 之 前 的 代码 中 看 出 的 ，ASPNET MVC 控制 器 方法 的 主体 通常 分 为 两 部 分 : 
操作 结果 的 获取 ,以 及 操作 结果 的 处 理 。 是 耕 将 这 两 个 阶段 分 离 取 决 于 你 。 只 要 你 仅 在 JSON 
和 XML 之 间 做 选择 ， 该 问题 就 不 难处 理 。 不 过 ， 如 果 有 多 个 格式 要 处 理 又 怎么 办 呢 ? 而 且 ， 
如 果 服 务 已 经 位 于 生产 环境 中 ， 但 你 必须 为 所 有 方法 添加 一 个 新 格式 ， 这 时 又 该 怎么 办 呢 ? 

此 时 就 需要 一 个 更 好 的 策略 以 用 于 响应 格式 的 协商 ,并 且 Web API 中 已 经 提供 了 该 策略 。 
10.3.2” 内容 协 商 是 如 何在 Web API 中 运行 的 

在 Web API 中 , 内 容 协 商 一 词 指 的 是 检查 传 入 请 求 结构 (通常 是 HITP 标 头 ) 的 处 理 过 程 ， 
以 便 确定 客户 端 想 要 接收 的 一 个 (或 多 个 ) 理 想 啊 应 格式 。 

1. 涉及 的 HTTP 标 头 


在 Web API 中 ， 有 两 个 HITP 标 头 在 内 容 协商 中 扮演 了 关键 角色 。 它 们 就 是 Accept 与 
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Content-Type。 这 两 者 中 ， 起 主要 作用 的 是 Accept， 这 是 因为 Content-Type 只 有 在 Accept 标 
头 缺失 或 具有 无 效 内 容 的 情况 下 才 会 起 作用 。 以 下 代码 显示 了 如 何在 调用 Web API 端点 的 
jQuery 调用 中 设置 Accept 标 头 以 接收 一 些 返 回 的 XML。 
$5.ajax(t{ 
url: "/api/news/all™, 
Lype: “GET”， 
headers: { Accept: "text/xml; charset=utf-8"™ } 
}); 


在 C# 代 码 中 ， 你 要 像 下 面 这 样 设置 Accept 标 头 : 


var client = new WebClient ().; 

cllient.Headers.Add ("Accept", "text/xml; charset=utf-8"); 

ApiController 类 内 部 具有 一 段 代码 以 处 理由 每 个 方法 返回 的 数据 并 将 该 原始 数据 转换 成 
合适 的 JSON 或 XML。 原始 结果 的 生成 与 格式 化 之 间 的 有 序 分 离 在 Web API 中 是 原生 的 , 并 
且 作 为 开发 人 员 ， 可 以 选择 XML 或 JSON 而 无 须 对 租 入 式 格式 化 器 组 件 的 细节 进行 公开 。 
通过 使 用 Web API， 你 就 可 以 相应 地 对 JSON 或 XML 使 用 自动 化 和 自由 序列 化 。 

如 果 缺 少 Accept 标 头 ， 或 者 具有 一 些 无 效 内 容 ，Web API 就 会 检查 Content-Type 标 头 。 
如 果 该 标 头 只 有 有 效 内 容 ， 则 其 内 容 就 会 用 来 格式 化 结 采 。 如 条 通过 Accept 或 Content-Type 
不 能 确定 有 效 的 序列 化 格式 ，Web API 就 会 选取 注册 到 运行 时 的 第 一 个 格式 化 器 。 默 认 情况 
下 ， 它 是 JSON 格式 化 器 。 


2. 修改 默认 格式 化 器 


谈 及 将 返回 数据 格式 化 成 JSON 的 服务 时 ,一 个 第 见 问题 就 是 在 JavaScript 客户 疹 和 .NET 
客户 端 中 使 用 时 ， 对 象 属性 名 称 的 大 小 写 问 题 。 在 NET 和 J avaScript( 以 及 相 应 程度 的 Java) 
中 ， 默 认 使 用 的 是 骆驼 命名 法 (camelCasing)。 然 而 ， 在 单纯 的 NET 中 ， 默认 使 用 的 是 帕斯卡 
命名 法 (PascalCasing)。 由 于 你 是 在 C# 中 编写 服务 ， 因 此 你 很 可 能 会 使 用 帕斯卡 命名 法 来 定义 
数据 传输 对 象 (DTO)。 而 当 此 数据 被 JavaScript 端 接收 时 就 会 产生 冲突 。 

作为 棕 换 默认 格式 化 器 的 示例 ， 让 我 们 从 提供 特殊 类 型 格式 化 器 的 各 种 社区 项 目 中 选取 
一 个 。 我 使 用 了 JsonCamelCaseFormatter， 可 以 在 https://gist.github.conyrdinewall/2012642 处 
找到 它 。 这 个 类 修改 了 JSON 数据 序列 化 的 方式 ， 以 确保 将 骆驼 命名 法 应 用 到 成 员 名 称 。 

自 定义 格式 化 器 就 是 一 个 继承 白 MediaTypeFormatter 的 类 的 实例 ， 并 且 重 写 了 4 个 关键 
方法 : CanReadType、CanWriteType、ReadFromStreamAsync 以 及 WriteTIoStreamAsync。 这 些 
方法 的 名 称 能 够 一 目 了 然 地 表明 其 用 途 。 这 里 是 你 怎样 才能 注册 新 的 JSON 格式 化 器 的 代码 : 

Public static class WebApiConfig 

{ 
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public static vold Register (HttpConfiguration config) 

{ 
Var index = config.Formatters.IndexOof (config.Formatters. JsonFormatter); 
config.Formatters[index] = new JsonCamelCaseFormatter(); 


} 

尤其 是 ， 访 示例 显示 了 如 何 用 JsonCamelCaseFormatter 的 实例 替换 默认 的 JSON 格式 化 
器 一 一 JsonMediaTypeFormatter 的 一 个 实例 。 如 果 只 想 将 男 一 个 格式 化 器 添加 到 该 列表 ， 可 以 
使 用 HttpConfiguration 对 象 的 Formatters 集合 上 的 Insert 或 Add 方法 。 

3. 为 特殊 类 型 定义 格式 化 器 

男 一 个 我 经 常 过 到 的 常见 情形 是 ， 和 面临 返回 一 些 类 型 的 不 同 格式 的 需求 ， 尤 其 是 不 同 的 
XML 染 构 。 前 和 面 提 到 的 CanReadType 和 CanWriteType 方法 都 能 为 此 提供 : - 些 帮 助 。 以 下 是 
News 类 型 的 一 个 自 定义 XML 格式 化 器 : 


public class NewsXmlFormatter : MediaTypeFormatter 


{ 
public NewsXmlFormatter () 
{ 
supportedMediaTypes.Add (new MediaTypeHeaderValue 
("application/xml"™")); 
SsupportedMediaTypes.Add (new MediaTypeHeaderVvalue ("text/xml")); 
} 


public override bool CanReadType (Type type) 
{ 


return false: 


public override bool CanWriteType (Type type) 

{ 
Var result = (type == typeof (News) || type == typeof (IList<News>)); 
return result,; 


public override Task WriteToStreamAsync (Type type, 
Object value, 
stream writestream, 
HttpcCcontent content, 
TransportcCcontext transportcCcontext) 


return Task.Factory.startNew! 


第 10 章 Web API 的 执行 指南 


(三 > 
{ 
Var listoOfNews = (IList<News>) value; 
using (var writer = new StreamWriter (writestream)) 
{ 
foreach {var n in listoOfNews) 
‘ 
writer.WriteLine ("<news>"); 
writer.WriteLine ("<title>{0}</title>™", n.Title):; 
writer.WwriteLine ("</news>"); 
} 
} 
}); 


} 
格式 化 右 仪 会 处 理 序列 化 ， 并 忽略 反 序列 化 (参见 图 10-5)。 


oe mm 


Eile Edit Rules Iools View Help ee 
人 $y Replay WK Pb Resume 时 sm Decose Keep: All sessions * 二 Any process 骆 Find 加 5ave 图 恒 Browse -化 ClearCache  - 


Web Sessions | | Filters 


GET /api/news/all?count=5 HTTP/.1 
Chlient 
Accept: text/aml; dharset=utf-8 
Accept-Encoding: gziprdeflate ,sddh 
AcceptL anguage: ens engq=0.8 
User-Agent: Moailla/5.0 (Windows NT 6. 1: WOWS® AppleWebkit/s37. 35 (KHTML, like Gecko) Chrom 


ache=Control: no=cache 


= ogee 
51 


Connecti Cn: CIl Dse 


去 站 丰 辐 写字 

<titlesLive Now: Nadal vs. Wawrinka</titles 

/MNEs 

世 首 并 鲁 本 交 

<titlesLive Now: DoKovic v3. Haas</title 

</NEWS> 

<News> 

<titlie>Tsonga Stuns Federer To Keep French Dream Alive</title> 
/NEWSs> 


甩 岂 并 全 所 闻 

<titlesPeya/soares Reach First Slam Semi</titles 

/MENS 

过 门 虹 鲁 于 和 

<titlesTsonga Thanks Federer, Breaks Out The "Bubbly' </title> 
</NEWSs> 


Find,.. (press Ctrl-+Enter to highlight all) | Viewin Notepad | 


http: /localhost:25708 /api/news/all?count=5 


到 10-5 通过 自 定 义 XML 格式 化 器 为 XML 数据 请 求 提供 服务 


现在 ， 问 题 就 变 成 了 你 如 何 能 确保 该 格式 化 器 的 调用 仅 用 于 特定 类 型 ， 并 且 默 认 的 格式 
化 器 用 于 其 他 情况 。 这 主要 取决 于 Web API 运行 时 注册 格式 化 器 的 顺序 。 
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var XmlIndex = config.Formatters.IndexOof (config.Formatters.XmlFormatter); 
config.Formatters.1Insert (xmlIndex, new NewsXmlFormatter () ) ; 


上 面 的 代码 会 将 特定 类 型 的 XML 格式 化 器 插入 到 通用 格式 化 器 之 前 。 这 样 一 来 ， 它 就 
能 被 首先 调用 了 。 


10.4 本 曹 小 结 


本 章 主要 介绍 了 短期 内 会 在 Web 解决 方案 中 扮演 重要 角色 的 框架 。 正 如 第 12 章 “ 让 网 
站 对 移动 端 友 好 ”中 会 明确 指出 的 ， 现 今 ，Web 解决 方案 有 时 是 由 混合 的 静态 HTML 标记 组 
成 的 ， 该 混合 标记 带 有 由 运行 中 的 来 自 远 程 后 端的 数据 生成 的 动态 节 。 该 远程 后 端的 特征 一 
直 都 在 不 断 变化 。 它 最 初 是 基于 SOAP 的 Web 服务 , 然后 是 WCF 服务 , 再 之 后 就 是 ASPNET 
MVC 应 用 程序 的 一 部 分 。 

Web API 总 是 与 ASPNET MVC 控制 器 一 样 精简 且 易 于 编码 。 不 过 ,不 仅 如 此 ，Web API 
还 不 依赖 于 ASPNET 框架 并 且 甚 至 能 够 在 IS 之 外 托管 ， 例 如 托管 在 Windows 服务 中 。 

Web API 是 一 个 成 熟 的 框架 ; 它 应 该 有 一 本 恰如其分 地 叙述 其 所 涉及 内 容 的 书 。 本 章 从 
ASPNET MVC 开发 人 员 的 角度 简要 介绍 了 其 经 典 轮廓 。Web API 是 一 个 设计 选项 ， 但 如 果 
只 是 要 设置 一 个 网 站 的 话 ， 我 不 认为 你 会 需要 使 用 它 。 如 果 你 考虑 的 正 是 这 种 情形 ， 那 么 
Web API 很 可 能 对 你 蝇 无 用 处 。 但 如 果 预 见 了 用 于 一 些 核心 SDK 的 多 个 前 端 ， 那 么 Web API 
就 能 起 到 很 大 帮助 ， 因 为 这 正 是 其 被 特别 创建 的 目的 。 
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有 效 的 JavaScript 


一 个 人 的 出 身 并 不 重要 ， 重 要 的 是 他 成 长 为 什么 样 的 人 。 
—J. K. Rowling 


JavaScript 是 在 20 世纪 90 年 代为 Web 而 开 友 的 ， 如 今 JavaScript 已 经 三 泛 用 于 Web 应 
用 程序 之 外 的 领域 。 例 如 ， 你 会 发 现 JavaScript 被 用 于 为 Adobe Photoshop、 人 和 谷歌 Chrome 和 
Mozilla Firefox 编 与 应 用 程序 扩展 。 它 也 被 用 于 创建 本 地 移动 应 用 程序 ; 比如 PhoneGap 或 
Appcelerator Titanium。JavaScript 还 被 用 于 茶 些 关 型 的 服务 堆 病 应 用 和 程序， 最 引 人 注 目的 融 
是 Node.js。 

JavaScript 的 命运 很 奇特 。 它 作为 首 批 Web 粉丝 的 语言 而 诞生 ， 从 20 世纪 90 年 代 初 期 
开始 经 内 了 一 系列 的 高 峰 和 低谷 。 在 茶 种 程度 上 ， 它 的 使 用 受到 了 动态 HIML 出 现 的 推动 ， 
但 随 看 与 Java Server Pages 和 ASPNET 的 整合 义 在 短 短 几 年 内 沉 我 了 ;因为 Web 开 及 的 重点 
义 重 新 回 到 了 服务 器 端 。 随 着 Ajax 的 使 用 ，JavaScript 再 次 恢复 了 生机 ， 并 且 Node.js 和 移 
动 框 染 的 出 现 强 化 了 它 的 生命 力 。 正 如 本 章 开 头 那 句 格 言 提醒 我 们 的 那样 ，JavaScript 的 出 生 
并 个 重要 ; 它 的 成 长 和 友 展 才 吏 共 影 啊 力 。 

JavaScript 是 一 种 很 容易 上 手 的 编程 语言 ;但 同时 ， 对 它 的 掌握 不 容 小 鹿 。 

如 今 所 有 的 Web 应 用 程序 都 被 要 求 添加 越 来 越 多 的 客户 端 功能 。 这 不 仪 是 指 客户 端的 验 
证 和 工具 ， 而 是 指 整 个 Ajax 应 用 程序 。 一 个 完整 的 Ajax 应 用 程序 是 将 页 面 交 互 减少 到 最 低 
限度 的 Web 应 用 程序 。 一 个 完整 的 Ajax 应 用 程序 集中 于 极 少 的 几 个 核心 页 面 ， 这 些 页 面 的 
用 户 界 和 面 随 着 用 户 的 操作 以 交互 方式 进行 变更 。 显 然 , 在 HIML 文档 对 象 模型 (DOM) 上 做 的 
大 量 工 作 都 需要 使 用 JavaScript。 


注意 : 

作为 ASPNET MVC 开发 人 员 ， 你 要 准备 好 编写 越 来 越 多 的 JavaScript 代码 。 更 重要 的 
是 ， 你 要 准备 好 导入 别人 编写 的 越 来 越 多 的 JavaScript 代码 。 这 两 者 并 不 是 互 不 的 。 实 际 上 ， 
现在 几乎 没有 哪个 网 站 的 代码 编写 不 从 ]Query 和 其 他 一 些 库 ， 如 AneularJS、 knockoutJS 或 
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Modernizr， 了 媚 入 功能 了 。 
11.1 重 温 JavaScript 语言 


JavaScript 是 一 种 个 寻 第 的 语言 ， 因 为 它 古 为 非 开 友人 员 有 所 创建 ; 其 进入 1 门 权 人 很 低 ， 叉 在 
够 灵活 ， 专 家 可 以 用 它 来 做 他 们 想 做 的 几乎 一 切 事情 。 依 我 之 见 ， 如 今 所 面临 的 挑战 是 ， 普 
通 的 JavaScript 开发 人 员 如 何 用 一 些 优秀 的 设计 来 创建 有 效 的 内 容 ， 同 时 将 可 读 性 和 可 维护 
性 保持 在 适当 的 水 平 上 。 为 此 ， 本 节 则 在 重新 整理 JavaScript 的 一 些 基本 情况 。 
11.1.1 语言 基础 知识 

JavaScript 碟 解 群 侍 代 三 ， 意 即 JavaScript 程序 需要 一 个 坏 境 以 便 在 其 中 运行 。 它 们 的 天 
然 运行 环境 是 Web 浏览 器 。 该 语言 的 语法 由 一 种 健壮 的 标准 ECMA 262 所 驱动 , 它 也 被 称 为 
ISO/IEC 16262:201。 经 过 这 么 多 年 的 发 展 ， 产生 了 一 些 基于 该 标准 的 不 同 实现 的 JavaScript 
语文 。 有 时 候 ， 这 些 语文 有 看 完全 不 同 的 名 称 ， 如 JScript、 JScriptNET、 ActionScript 和 
EcmaScript。 但 归根 结 底 ， 都 是 由 不 同 引擎 处 理 JavaScript 源 代码 的 结果 。 经 常 与 Web 浏览 
器 相关 联 的 流行 引擎 有 V8( 谷 歌 Chrome)、Chakra( 微 软 Internet Explorer)、Gecko(Firefox) 和 
Opera 。 

让 我 们 简要 地 浏览 一 下 该 语言 的 基础 知识 ， 并 重新 整理 一 下 被 大 多 数 ASPNET 开发 人 
员 拿 起 来 在 用 但 从 未 深 Mi 些 概念 。 


1. 类 型 系统 


JavaScript 类 型 系统 包括 基本 类 型 和 几 个 内 置 对 象 。 不 过 当 你 编写 JavaScript 代码 时 ， 可 
以 使 用 的 类 型 范围 实际 上 更 大 。 除 了 使 用 内 置 的 对 象 ， 还 可 以 依赖 由 宿主 提供 的 对 象 。 典 型 
的 例子 就 是 最 常见 的 JavaScript 竹 主 一 一 Web 浏 览 器 一 一 发 布 到 JavaScript 引擎 中 的 窗口 对 象 。 

基本 类 型 是 number、 strng、 Boolean、null、undefined、Object 和 function。 内 置 的 对 象 
十 Aray、Math、Date、Error、RegExp， 以 及 几 个 用 于 基本 类 型 的 封装 对 象 : strng、 Boolean 
和 number。 

number 类 型 表示 市 有 0 或 更 多 小 数位 数 的 浮 点 数 。 没 有 用 于 整数 、 长 整数 或 字 节 的 单独 
类 型 。 数 字 的 范围 介 于 -10 ”和 10” 之 间 。 可 以 写 入 十 进 制 、 八 进 制 或 十 六 进 制 格式 的 数字 。 
特别 的 数字 NaN 表示 没有 意义 的 数学 运算 结果 (如 被 零 除 )。 

string 类 型 表示 具有 0 个 或 更 多 个 字符 的 行 ， 它 并 不 表示 一 个 数组 。 单 个 字符 由 一 个 字 
符 的 字符 串 表 示 。 字 符 串 中 的 特殊 字符 以 肥 斜 枉 开头 ， 比 如 表示 一 个 回 车 符 。 字 符 串 的 
内 容 要 放 进 一 对 单 引 号 或 双 引 号 内 。 基 本 值 被 封装 在 添加 了 几 个 方法 的 字符 串 对 象 中 ， 这 些 
方法 包括 split 和 substring。 
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2. Null 对 比 undefined 


不 包含 有 意义 值 的 JavaScript 变量 可 以 被 分 配 为 null 值 和 undefined 值 。 两 者 的 区 别 是 什 
么 呢 ? 就 空 值 而 言 ， JavaScript 采用 了 一 个 像 C# 和 Java 这 样 的 高 级 语言 都 会 错过 的 细微 差别 。 

具体 来 说 ，undefined 是 运行 时 环境 分 配给 所 有 正在 声明 的 变量 的 默认 值 。 最 引 人 注 意 的 
是 ， 未 赋值 的 变量 包含 undefined， 但 不 包含 null 或 某 些 默认 值 ， 这 和 在 C# 中 一 样 。 男 一 方 
面 ，null 仍 是 一 个 表示 null、 空 或 不 存在 引用 的 值 ， 但 它 是 由 开发 人 员 显 式 分 配 的 。 简 单 地 
说 ， 一 个 设置 为 undefined 的 变量 不 会 被 任何 代码 触及 到 ;， 而 包含 null 的 变量 会 通过 你 代码 
中 的 一 些 路 人 径 被 分 配 到 茶 个 值 。 

如 果 在 未 赋值 的 变量 上 运行 typeof， 就 会 得 到 undefined 一 一 它 本 号 就 是 一 种 独特 的 类 型 。 
如 果 在 被 赋予 null 值 的 变量 上 运行 typeof， 你 会 获得 object。 注 意 下 面 的 代码 : 

Var XxX; // hence, undefined 

Var y = null; 

如 果 比 较 一 下 x 和 yy 会 发 生 什么 ”如果 使 用 == 运 算 符 来 比较 ,会 得 到 true， 即 undefined 
的 最 终 计 算 结果 为 null。 如 果 使 用 = 运算 符 比较 ， 会 得 到 false: 两 个 变量 持 有 相同 的 值 ， 
却 是 不 同 的 类 型 。 


3. 局 部 变量 和 全 局 变量 


在 JavaScript 中 ， 变 量 是 一 个 并 不 局 限于 总 是 存储 固定 类 型 值 的 存储 位 置 。 被 分 配 了 一 
个 值 后 ， 变 量 就 会 承接 被 存储 的 数据 类 型 。 因 此 ， JavaScript 变量 可 能 在 其 生命 周期 中 几 次 更 
改 它 的 类 型 。 

Var data = "dino"; // now data 1s of type string 

data = 123; // now data 1s of type number 

这 种 行为 有 别 于 C# 变 量 的 典型 行为 ， 除 非 C# 变 量 被 定义 为 NET4 中 的 动态 类 型 。 在 首 
度 使 用 时 变量 就 被 赋予 了 生命 ， 在 这 之 前 ， 它 们 只 会 具有 一 个 undefined 值 。 

在 定义 变量 时 ， 你 应 一 直 使 用 var 关键 字 作 为 对 解析 器 和 你 自己 的 提示 。var 关键 字 并 
非 绝 对 必要 ， 但 强烈 建议 使 用 。 如 果 通 过 使 用 var 对 变量 进行 了 声明 ， 那 么 在 函数 内 定义 的 
变量 就 会 仅 限 于 这 个 函数 。 如 果 没 有 声明 ， 变 量 会 被 视 为 全 局 的 ， 但 它们 会 保持 undefined， 
直到 函数 执行 一 次 。 在 全 局 范围 中 声明 的 变量 都 是 全 局 变量 ， 无 论 是 否 使 用 var。 

<script type="text/Javascript"> 

Var rootserver = "http://www.expoware .org/"; // global 


section = "mobile"™; // global 
</script> 


371 


3712 


第 川 部 分 “移动 客户 端 


<ScCript> 
function doSsomething() { 
Var temp = 1; // local 
mode = 0; // global, but undefined until called 
} 
</script> 


JavaScript 运行 时 环境 会 将 全 局 变量 存储 为 通过 this 关键 字 引 用 的 隐藏 对 象 的 属性 。 浏 
览 器 往往 通过 窗口 对 象 反 射 该 对 象 。 

在 所 有 的 编程 语言 中 ， 能 够 使 用 全 局 变量 都 会 使 编码 变 得 更 容易 。 然 而 ， 全 局 变量 也 有 
负面 影响 。 其 主要 缺点 是 ， 在 你 的 代码 、 第 三 方 库 、 广 告 合 作 伙伴 和 分 析 库 的 不 同 部 分 中 所 
定义 的 变量 之 间 存 在 着 名 称 冲突 的 风险 。 名 称 冲突 加 上 JavaScript 变量 的 动态 类 型 可 能 会 导 
致 你 无 意 中 修 改 了 应 用 程序 的 状态 ， 进 而 在 运行 时 产生 令 人 人 不快 的 寞 常 。 

需要 注意 很 容易 就 会 无 心地 创建 出 全 局 变量 : 缺失 var 的 话 ， 你 最 终 获 得 的 就 是 全 局 变 
量 ; 在 赋值 中 键入 错误 的 变量 名 称 ， 也 会 得 到 一 个 新 的 全 局 变量 。 这 后 一 种 特点 是 很 可 能 
现 的 ， 因 为 在 JavaScript 中 ， 可 以 在 无 顷 首 先 声 明 变 量 的 情况 下 使 用 它 。 当 你 需要 使 用 全 局 
变量 时 ， 一 个 好 的 技巧 是 将 它们 作为 封装 对 象 的 属性 来 创建 。 在 从 每 个 页 面 都 可 以 链接 的 
JavaScript 文件 中 放置 以 下 代码 : 

Var GLOBALS = (function(} { return this; }()): 

接 下 来 使 用 GLOBALS.Xxx， 这 里 的 Xxx 是 任何 你 可 能 需要 的 全 局 变量 。 这 人 至 少 可 以 确 
保 你 的 全 局 变量 容易 辨识 。 

一 个 更 好 的 方法 是 干脆 不 使 用 全 局 名 称 空 间 和 this 对 象 ， 而 改 用 全 新 的 全 局 字典 对 象 。 
将 其 如 下 面 这 样 初始 化 : 

Var GLOBALS = GLOBALS || {}; 


如 果 在 应 用 程序 中 使 用 多 个 需要 引用 GLOBALS 的 JavaScript 文件 ， 那 么 你 就 要 将 上 面 
那 行 代码 放置 在 每 个 文件 的 第 一 行 。 该 语法 中 的 | 会 确保 不 会 在 每 次 文件 被 处 理 时 重新 初始 化 。 

注意 : 

JSLint( 可 以 在 http://www.jslint.com 找到 ) 一 一 用 于 JavaScript 代码 统计 分 析 的 一 款 在 线 工 
具 一 一 能 够 帮助 捕获 你 代码 中 的 反 模 式 ， 包 括 var 关键 字 的 缺失 。 

4. 变量 与 提升 

提升 是 JavaScript 的 一 个 特性 ， 通 过 它 开 及 人 员 可 以 在 范围 中 的 任何 地 方 声明 变量 并 在 
该 范围 中 的 任何 地 方 使 用 这 些 变量 。 在 JavaScript 中 ， 可 以 先 使 用 变量 ， 之 后 壬 声明 它 ( 作 为 
var)， 如 下 所 示 : 
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function() I // Not allowed In C# 
mode = 二; 


ee mode; 

} 

其 整体 行为 就 如 该 var 语句 被 放置 在 顶部 一 样 。 历 史上 , 该 特性 的 引入 就 是 为 了 JavaScript 
具有 尽 可 能 低 的 使 用 门槛 。 不 过 ， 当 你 使 用 JavaScript 来 编写 代码 的 重要 部 分 时 ， 提 升 会 成 
为 混乱 的 明显 来 源 并 且 变 得 容易 出 错 。 一 个 民 好 习惯 是 将 你 所 有 的 变量 放置 在 每 个 函数 的 顶 
部 一 一 最 好 是 放置 在 单个 var 语句 中 ， 如 下 所 示 : 

function() I 

Var start = 0, 


total = 10, 
sum = function (x,y) {return xt+y;}, 


lindex; 
} 
JSLint 可 被 指示 来 捕获 在 单个 函数 中 使 用 的 多 个 var 语句 , 并 提示 你 与 此 模式 有 关 的 信息 。 
5. 对 象 


不 将 JavaScript 归 类 成 面向 对 象 语言 的 主要 原因 是 , 你 从 JavaScript 得 到 的 对 象 定义 与 被 
普 过 接受 的 对 象 概念 个 同 ， 后 者 是 你 从 像 C++ 或 C# 这 样 的 经 典 面 问 对 象 语言 中 得 到 的 。 

在 JavaScript 中 ， 对 象 是 一 个 名 称 / 值 对 的 字典 。 其 对 象 的 设计 结构 是 隐 式 的 ， 你 无 法 获 
取 。JavaScript 对 象 通常 只 具有 数据 ， 但 可 以 添加 行为 。 对 象 的 ( 显 式 ) 结 构 可 以 在 任何 时 候 使 
用 新 方法 和 属性 进行 修改 ; 但 其 隐 式 结构 永远 无 法 修改 。 正 是 由 于 该 隐 式 设计 结构 , JavaScript 
中 任何 明显 的 空 日 对 象 都 仍然 具有 一 些 属性 ， 比 如 原型 ( 稍 后 我 将 介绍 原型 )。 

请 记 住 ， 存 储 对 象 的 变量 实际 上 并 不 会 包含 该 对 象 的 字典 ， 它 们 只 是 引用 该 对 象 的 属性 
包 而 已 。 属 性 包 与 变量 存储 人 不同， 并且 不 同 的 变量 可 以 引用 相同 的 数据 包 。new 运算 符 会 创 
建新 的 属性 包 。 当 你 传递 一 个 对 象 时 ， 只 需要 传递 包 的 引用 即 可 。 

将 一 个 成 员 添 加 到 JavaScript 对 象 只 会 在 特定 实例 起 作用 。 如 果 想 要 将 一 个 新 成 员 添 加 
到 被 创建 成 某 类 型 的 所 有 实例 ， 就 必须 将 该 成 员 添 加 到 对 象 的 原型 。 

1f (typeof Number.prototype.random === "undeflned") 1 

Number.prototype.random = function() 1 


Var n = Math.floor(Math.random() * OUU) 
return n; 
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注意 : 

增加 原生 对 象 的 原型 ， 被 一 些 开 发 人 员 认 为 是 不 好 的 做 法 (或 者 说 ， 至 少 值得 讨论 )， 因 
为 它 会 使 代码 降低 可 预测 性 并 损失 可 维护 性 。 总 体 而 言 ， 我 相信 这 是 值得 怀疑 的 ， 主 要 是 观 
点 角度 的 问题 。 我 的 观点 是 : 注意 洪 在 的 问题 并 按照 你 感觉 舒适 的 方式 来 进行 处 理 。 


可 以 使 用 Object 类 型 来 创建 值 和 方法 的 聚合 , 这 是 你 在 JavaScript 中 使 用 C# 对 象 最 可 行 
的 方式 。Object 构造 函数 的 直接 使 用 (如 下 所 示 ) 通 常会 被 忽视 : 


Var dog = new Object () ; 

dog.name = "Jerry Lee Esposito"; 

dog.getName = function() ({ 
return this.name; 


} 
一 种 更 好 的 方式 需要 使 用 对 象 字面 值 ， 如 下 所 示 : 
Var dog = { 

name: "Jerry Lee Esposito", 

getName: function() { 

return this.name; 

} 

} 7 


如 果 使 用 Object 的 构造 函数 ， 解 释 器 就 必须 解析 构造 函数 调用 的 范围 。 在 JavaScript 中 ， 
不 能 确保 范围 中 存在 的 本 地 对 象 具有 与 全 局 对 象 不 同 的 名 称 。 因 此 ， 解 释 器 必须 顺 着 堆栈 找 
出 与 构造 函数 所 应 用 的 最 近 的 定义 。 除 了 这 个 性 能 问题 之 外 ， 直 接 使 用 构造 函数 还 不 能 将 对 
象 作 为 字典 传输 ， 而 字典 恰恰 是 JavaScript 编程 的 关键 。 


6. 函数 


在 JavaScript 中 ， 了 负数 就是 捆绑 成 块 的 一 些 人 代码， 并 且 可 选择 性 为 其 命名 。 如 果 函 数 没 
有 指定 名 称 ， 则 其 就 是 匿名 函数 。 你 要 像 对 待 对 象 一 样 对 待 函 数 : 它们 可 以 具有 属性 ， 并 且 
可 以 传递 它们 并 与 之 进行 交互 。 

在 JavaScript 中 ,匿名 函数 是 函数 编程 的 支柱 。 匿名 函数 是 入 演算 (lambda calculus) 的 直 
接 分 文 ， 或 者 如 条 愿意 的 话 ， 也 可 以 成 为 一 种 老式 图 数 指针 的 语言 改造 。 以 下 是 匿名 函数 的 


Q) 入 演算 (Lambda calculus) 是 一 种 由 Alonzo Church 和 Stephen Kleene 于 1930 年 开发 的 程序 语言 数学 基 
础 ， 它 可 以 用 来 表示 所 有 可 计算 的 函数 。 在 对 可 计算 性 (也 是 可 构造 性 和 有 效 计算 性 ) 概 念 标准 化 的 努力 中 ， 
Church 和 Kleene 开发 出 一 种 只 需要 简单 的 句法 和 少量 的 语法 约束 强力 有 效 的 语言 。 这 种 语言 把 函数 程序 当 
成 它 的 一 个 参数 (一 个 函数 是 一 套 规则 )， 把 实体 像 其 他 变量 一 样 表 示 ， 一 个 函数 功能 对 男 一 个 对 的 调用 ， 或 
者 当成 “lambda 抽象 ”( 用 斋 肪 字母 lambda 表示 的 一 个 函数 定义 维 抽象 运算 )。 入 注 算 和 关羽 合成 志和 辑 和 分 
类 系统 理论 一 样 ， 他 们 是 学 习 数学 逻辑 和 计算 机 编程 语言 的 重要 基础 。 
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一 个 示例 : 


function(x, vy) I 
return x + ys 


} 


第 规 函 数 与 匿名 函数 之 则 的 唯一 区 别 就 是 其 名 称 不 同 (或 者 也 可 以 说 没有 区 别 )。 
使 用 函数 的 主要 原因 有 两 个 ; 一 个 是 创建 目 定 义 对 象 ， 另 一 个 当然 就 是 定义 可 重复 行为 。 
这 两 个 原因 中 ， 前 者 在 JavaScript 中 最 受 关注 。 请 思考 以 下 代码 : 


// The this object 1s implicitly returned 
Var Dog = function (name) { 
this.name = name; 
this.bark = function() 1{ 
return "bau™; 
}; 
}; 


要 使 用 Dog 对 象 ， 你 需要 使 用 经 典 的 new 构造 函数 对 其 实例 化 ， 如 下 所 示 : 


Var jerry = new Dog ("Jerry"); // OK 
Var hassle = Dog("hassie"™); // Doesn't throw but, worse, may alter 七 he 
application's state 


腑 烦 的 是 ， 就 算 你 态 记 了 new 运算 符 ， 也 不 会 得 到 任何 异常 且 你 的 代码 会 继续 运行 ,但 
是 使 用 的 this 对 象 现在 就 变 成 全 局 的 this 对 象 了 。 这 童 味 看 你 潜在 地 改变 了 应 用 程序 的 状态 。 
下 面 是 安全 的 应 对 持 施 : 


Var Dog = functlon (name) { 
var that = {1}:; 
that.name = name; 
that .bark = function() 1 
return "bau™; 
}; 
return that; 


}s 


不 同 之 处 在 于 ， 现 在 你 显 式 地 创建 并 返回 了 一 个 名 为 that 的 新 对 象 。 这 就 是 俗称 “使 用 
that 而 非 this” 的 模式 。 


11.1.2 ” JavaScript 中 的 面向 对 象 
曾几何时 ， 网 页 中 的 JavaScript 代码 仅 限 于 DOM 基本 操作 的 几 行 代码 。 也 就 没有 必要 
将 这 些 代 码 设计 为 可 重用 块 并 小 心地 将 其 附加 到 页 面 元 素 。 尽 管 JavaScript 代码 的 平均 复杂 


375 


第 川 部 分 “移动 客户 端 


水 平 与 不 久 以 前 差不多 相同 ， 但 每 个 页 面 上 的 代码 质量 要 求 已 显著 提高 了。 如 今 需 要 各 种 封 
装 形式 ， 因 为 JavaScript 代码 现在 就 像 是 其 自身 上 的 小 应 用 程序 一 般 。 你 需要 获得 可 重用 性 
以 及 (如 果 不 是 特殊 情况 的 话 ) 可 维护 性 。 再 者 ， 你 需要 确保 你 的 代码 独立 运行 ， 因 为 在 
JavaScript 中 ， 如 果 目 前 为 止 没 有 明显 的 指示 ， 很 容易 就 会 缺失 变量 、 破 坏 全 局 性 并 且 输 错 名 
称 。 在 这 一 点 上 ，JSLint 就 大 有 助 益 了 ， 但 它 并 不 像 一 个 编译 器 。 

为 了 完成 有 关 JavaScript 语言 基础 知识 的 讨论 ,让 我 介绍 一 下 闭 包 和 原型 一 一 可 以 用 来 在 
JavaScript 中 实现 面向 对 象 的 两 种 方式 。 


1. 让 对 象 具 有 类 的 外 观 


在 我 开始 介绍 闭 包 和 原型 之 前 ， 让 我 先 介绍 一 下 原生 Object 类 型 及 其 用 途 。 正 如 之 前 所 
描述 的 ， 可 以 使 用 new 关键 字 来 创建 一 个 像 字典 一 样 的 新 对 象 。 接 者 ， 你 要 将 数据 填充 进去 
并 通过 为 属性 名 称 编写 图 数 来 添加 一 些 方法 。 下 面 是 一 个 示例 : 


Var person = new Object () ; 
person.Name = "Dino"™; 
person.LastName = "Esposito"™; 
person.BirthDate = new Date(1979,10,17); 
person.getAge = function() { 
Var today = new Date () ; 
Var thisDay = today.getDate (); 
Var thisMonth = today.getMontn (); 
Var thisYear = today.getrFullYear () ; 
Var age = thisYear-this.BirthDate.getFullYear()-1; 
1f (thisMonthn > this.BirthDate.getMonth () ) 
age = age +l1; 
else 
if (thisMonth == this.BirthDate.getMonth() && 
thisDay >= this.BirthDate.getDate()) 
age = age +1; 
return age; 
} 
你 使 用 了 一 个 基于 人 的 属性 来 建 模 的 对 象 , 但 你 不 会 真正 具有 一 个 Person 对 象 。 正 如 你 
早 前 看 到 的 ， 这 样 做 会 有 可 读 性 和 性 能 方面 的 问题 。 此 外 ， 这 个 对 象 被 少 有 地 定义 为 多 行 。 
闭 包 和 原型 提供 了 另 一 种 方式 来 定义 类 型 的 布局 ， 并 且 它 们 是 用 于 在 JavaScript 中 进行 
面 癌 对 象 编程 的 原生 机 制 。 


2. 使 用 闭 包 
闭 包 是 编程 语言 的 一 个 通用 概念 。 应 用 到 JavaScript 时 ， 闭 包 就 是 一 个 能 在 相同 上 下 文 
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内 同时 定义 变量 和 方法 的 函数 。 以 这 种 方式 ， 最 外 层 (匿名 或 已 命名 的 ) 函 数 会 “关闭 ”表达 
式 。 这 里 有 一 个 用 于 表示 Person 类 型 的 函数 的 闭 包 模型 示例 : 


Var Person = function (name, lastname, birthdate) 1 
this.Name = name; 
this.LastName = lastname; 
this.BirthDate = birthdate; 
this.getAge = function() 1{ 
Var today = new Date()}; 
Var thisDay = today.getDate () ; 
Var thisMonth = today.getMonth () ; 
Var thisYear = today.getrFullYear (); 
Var age = thisYear-this.BirthDate.getFullYear()-—1; 
1f (thisMonth > this.BirthDate.getMonth()) 
age = age +1; 


else 
if (thisMonth == this.BirthnDate.getMonth() && 
thisDay >= this.BirthDate.getDate()) 
age = age +l1; 


return age; 


} 

如 你 所 见 ， 闭 包 就 是 伪 类 的 构造 函数 。 在 一 个 闭 包 模型 中 ， 构 造 函 数 包含 了 成 员 声 明 ， 
而 且 成 员 都 是 真正 封装 在 类 中 和 对 类 私有 的 。 此 外 ， 成 员 都 是 基于 实例 的 ， 这 会 提高 由 类 使 
用 的 内 存 。 这 里 有 一 个 如 何 使 用 该 对 象 的 例子 : 


Var p = new Person("Dino", "Esposito", new Date( ... ); 
alert (p.Name + "1s "+ p.getAge ()); 


闭 包 模 型 会 提供 完全 封装 ， 但 也 仅 此 而 已 了 。 要 构成 对 象 ， 你 只 能 借助 于 聚合 。 
3. 使 用 原型 


原型 模型 需要 通过 JavaScript 原型 对 象 来 定义 类 的 公共 结构 。 以 下 代码 示例 显示 了 如 何 
重 写 之 前 的 Person 类 以 避免 闭 包 : 
// Pseudo constructor 


Var Person = function (name, lastname, birthdate) { 
this.initialize (name, lastname, birthdate).; 


/ / Members 
Person.prototype.initialize = function (name, lastname, birthdate)  { 
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this.Name = name: 

this.LastName = lastname:;: 

this.BirthDate = birthdate.: 
} 


Person.prototype.getAge = function() 1 
Var today = new Date(); 
Var thisDay = today.getDate () ; 
Var thisMonth = today.getMonth (); 
Var thisYear = today.getrFullYear () ; 
var age = thisYear-this.BirthDate.getFullYear()-—1; 
1f (thisMonth > this.BirthDate.getMonth()) 
age = age +l1; 


else 
1f (thisMonth == this.BirthDate.getMonth() && 
thisDay >= this.BirthDate.getDate()) 
age = age +l1; 
return ager; 

} 

在 原型 模型 中 ， 构 造 函 数 与 成 员 被 清晰 分 离 ， 并 且 总 是 需要 一 个 构造 函数 。 就 私有 成 员 
而 言 ， 你 无 法 使 用 它们 了。 将 其 保持 在 本 地 闭 包 中 的 var 关键 字 ， 并 不 会 在 原型 模型 中 应 用 。 
所 以 , 可 以 为 你 打算 用 作 属 性 的 内 容 定 义 获取 器 /设置 器 , 但 支持 字段 仍 将 保持 可 从 外 部 访问 。 
可 以 值 助 于 一 些 内 部 约定 ， 比 如 你 打算 用 作 私 有 的 成 员 名 称 的 市 有 下 划 线 的 前 级 。 然 而 ， 这 
只 是 一 个 约定 而 已 ， 没 什么 能 够 阻止 开发 人 员 访 问 类 作者 认为 私有 的 内 容 。 

信 助 原型 特性 ， 就 可 以 通过 简单 地 将 派生 对 象 的 原型 属性 设置 成 “ 父 ” 对 象 的 实例 来 达 
到 继承 目的 。 

Developer = function Developer (name, lastname, birthdate) 

this.initialize (name, lastname, birthdate); 

RE = new Person(); 

请 注意 ， 总 是 需要 使 用 这 种 方式 从 任何 相关 成 员 图 数 内 部 引用 原型 成 员 。 

在 原型 模型 中 , 所 有 实例 都 能 共 宇 成 员 , 因为 这 些 成 员 都 是 在 共享 的 原型 对 象 上 调用 的 。 
以 这 种 方式 ， 就 能 减少 每 个 实例 使 用 的 内 存 大 小 ， 也 就 能 够 提供 更 快速 的 对 象 实 例 化 过 程 。 
除了 语法 特点 之 外 ， 原 型 模型 还 使 得 类 的 定义 远 比 闭 包 模型 更 类 似 于 经 典 的 面向 对 象 模型 。 


4. 普通 自 定义 对 象 与 类 层次 结构 的 对 比 
在 财 包 与 原型 之 间 做 选择 还 应 该 将 性 能 考量 和 浏览 吉 性 能 作为 依据 。 原 型 在 所有 浏览 攻 
中 都 具有 较 短 的 加 载 时 间 。 团 包 在 条 些 浏 宽 融 中 运行 极 佳 (例如 正 ) 但 在 为 一些 中 则 很 糟 。 
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原型 为 微软 智能 提示 提供 了 更 好 的 文 持 ， 并 且 用 在 像 微 软 Visual Studio 这 样 的 文 持 该 特 
性 的 工具 中 时 ， 原 型 会 提供 基于 工具 的 语句 补 全 。 使 用 反射 ， 原 型 还 能 帮助 你 获得 类 型 信息 。 
你 不 必 再 创建 类 型 实例 来 得 询 类 型 信息 了 ， 这 在 使 用 财 包 的 时 候 是 不 可 避免 的 。 最 后 ， 尿 型 
使 你 能 网 在 调试 时 轻易 地 浏览 私有 关 成 员 。 

因此 ， 在 处 理 外 观 和 关 一 样 的 JavaScript 对 象 时 ， 你 就 有 了 两 个 基本 选项 了 。 原 型 是 最 
第 被 库 设计 者 选择 的 选项 。 男 外 ， 在 jQuery 中 ， 原 型 属性 也 得 到 了 广泛 使 用 。 

话 虽 如 此 ， 如 有 果 不 得 不 为 Web 前 端 编写 客户 端 代码 的 话 ， 我 很 可 能 会 使 用 jQuery， 使 用 
大 量 匿 名 函数 ， 并 且 其 至 不 会 使 用 自 定 义 对 象 的 层次 结构 。 我 肯定 会 创建 日 定义 对 象 ， 但 我 
只 会 将 其 用 作 数 据 和 行为 的 普 退 而 平滑 的 容器 ， 其 中 不 具有 继承 性 或 多 态 性 。 男 一 方面 ， 如 
果 我 不 得 不 编写 目 己 的 框架 来 广 持 菜 些 服务 器 端 基础 架构 ， 我 很 可 能 会 选择 一 种 更 经 典 的 面 
同 对 象 方法 。 然而， 在 那 种 情况 下 , 我 可 能 会 考虑 使 用 一 个 现成 的 库 而 非 创建 一 个 上 自己 的 库 。 
对 此 ， MooTools(http:/mnootools.neD 束 是 -个 极 佳 的 选择 。 


11.2 jQuery 的 执行 摘要 


我 认为 如 果 现 在 要 在 Web 视图 中 编写 JavaSeript 代码 的 话 ， 你 很 可 能 使 用 jQuery。 如 果 
没有 ， 那 么 应 该 使 用 ， 唯 一 我 认为 可 以 不 使 用 jQuery 的 合理 场景 是 移动 网 站 。 要 能 让 你 在 
DOM 操作 和 事件 处 理 方面 省 力 ， JQuery 库 肯 定 不 是 你 能 选用 的 唯一 JavaScript 库 。 不 过 ， 
它 是 全 球 的 业界 标准 。 我 认为 jQuery 几乎 就 是 JavaScript 语言 的 扩展 ， 并 且 肯 定 是 任何 Web 
开 及 人 员 JavaScript 拉 能 的 扩展 。 

在 本 章 中 ， 你 不 会 看 见 对 jQuery 的 广泛 介绍 。 对 于 这 方面 的 内 容 ， 可 以 选择 一 些 合适 的 
书籍 或 查看 http://docs.jquery.com/Main Page 处 的 在 线 文档 。 如 果 要 寻找 更 具 可 读 性 的 在 线 内 
容 而 不 是 枯燥 的 文档 ， 请 丛 看 http://jqfundamentals.com/book。 

在 这 一 草 ， 我 会 介绍 jQuery 中 关键 概念 的 概况 ， 对 这 些 概念 的 足够 理解 能 让 你 快速 掌握 
jQuery 库 中 的 编程 细节 和 特性 。 


11.2.1 DOM 查询 与 包装 集 


jQuery 库 在 世界 范围 内 大 获 成 功 的 主要 原因 在 于 其 对 函数 及 DOM 编程 的 独特 混合 。 该 
库 的 工作 原理 是 选择 DOM 元 素 并 将 函数 应 用 于 这 些 元 素 ， 而 这 正 是 客户 端 Web 开发 人 员 需 
要 在 大 多 数 时 候 完 成 的 任务 。 


1. 根 对 象 
jQuery 库 的 根 就 是 jQuery 函数 。 以 下 是 该 库 的 整体 


结构 : 
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( 
function( window, undefined ) 
{ 
var JQuery = (function() { 
// Define a local copy of JQuery 
var JQuery = function(selector, context) { 
} 
return JQuery; 
}) (5 
/* the rest of the library goes here */ 
Window.JQuery = window.$ = JQuery; 
} 


) (window); 


该 幅 套 jQuery 函数 被 映射 成 浏览 右 窗 口 对 象 的 扩展 并 且 用 流行 的 $ 函 数 作为 别名 
数 具有 以 下 原型 : 


function (selector, context) 


选择 器 表示 在 DOM 上 运行 的 查询 表达 式 ; 上 下 文 表 示 从 DOM 的 哪个 部 分 运行 该 查询 。 
如 果 没 有 指定 上 下 文 ， 则 jQuery 函数 会 在 整个 页 面 DOM 中 查找 DOM 元 素 。 

jQuery 函数 通 弟 返回 一 个 包装 集 一 一 也 就 是 DOM 元 素 的 集合 。 非 常 棒 的 是 ， 这 个 包装 
集 仍然 是 jQuery 对 象 ， 可 使 用 相同 的 语法 来 查询 ， 并 产生 一 系列 查询 。 


2. 运行 查询 


库 名 称 中 的 query 这 个 词 说 明了 一 切 4 代表 的 是 JavaScript， 这 一 点 你 已 经 知道 了 ) 一 一 
jQuery 库 的 主要 目的 是 运行 针对 DOM 的 (明智 ) 查 询 并 执行 针对 返回 项 的 操作 。 

该 库 背 后 的 查询 引擎 已 经 远 不 止 简 单 的 搜索 功能 了 ， 例如， 你 能 在 DOM 找到 的 原生 的 
document.getElementById( 以 及 相关 函数 ) 这 样 一 些 简 单 搜 索 ,jQuery 的 查询 功能 使 用 了 强大 的 
CSS 语法 ， 它 为 你 赋予 了 惊人 的 表达 性 水 平 。 只 有 在 HIMLS 的 DOM 中 你 才 会 发 现 类 似 的 
查询 表达 性 ， 而 HIML5 中 的 CSS 语法 受到 了 广泛 而 统一 的 支持 。 

一 个 查询 结果 就 是 一 个 包装 集 。 包 装 集 是 包含 DOM 元 素 集合 的 对 象 。 元 素 会 按照 其 在 
原始 文档 中 出 现 的 顺序 被 添加 到 集合 中 。 

即使 没有 找到 匹配 元 素 ， 包 装 集 也 绝 不 会 为 空 。 可 以 通过 得 看 jQuery 对 象 的 length 属性 
来 检查 包装 集 的 实际 大 小 ， 如 下 所 示 : 
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// Queries for all IMG tags in the page 
Var wrappedset = new JQuery ("img"); 

var length = wrappedset .length; 

if (length == 0) 

alert ("No IMG tags found.™); 


请 注意 上 面 所 示 的 表达 式 ， 通 过 它 你 就 能 得 到 包 淡 集 ， 该 表达 式 等 效 于 更 常用 的 


$(“img”). 
包 痰 集 并 不 是 一 个 特殊 的 数据 容器 。“ 包 北 集 ”是 一 个 表明 但 询 结果 的 特定 jQuery 术语 。 


3. 枚 举 包装 集 的 内 容 


为 了 循环 遍历 包装 集中 的 元 素 , 你 要 使 用 each 函数 。 此 函数 会 将 一 个 函数 用 作 参 数 并 基 
于 每 个 元 素 调用 它 : 

// Prints out names of all images 

$ ("1mg") .each (function (index) { 

alert (this.src}); 

}); 

传递 给 每 个 元 素 的 回调 函数 会 接收 到 当前 迭代 的 从 0 开始 计数 的 索引 。 非 弟 棒 的 是 ， 你 
不 需要 亲自 检索 相应 的 DOM 元 素 ; 只 需要 使 用 this 关键 字 来 引用 当前 正在 处 理 的 元 素 即 可 。 
如 果 回 调 函 数 返 回 false， 迭 代 就 会 停止 。 请 注意 ，each 是 一 个 非常 通用 的 函数 ， 可 用 于 不 存 
在 更 特定 jQuery 函数 的 任何 任务 。 如 果 发 现 已 经 存在 一 个 jQuery 函数 能 够 完成 你 想 要 通过 
编码 进行 处 理 的 任务 ， 请 务必 使 用 原生 的 图 数 。 

可 以 使 用 length 属性 来 读 取 包 装 集 的 大 小 。 也 可 以 使 用 size 图 数 ， 但 length 属性 会 稍微 
快 一 点 。 

// You better Use the length property 

alert($ ("1img") .size (}) ); 

get 国 数 会 从 jQuery 对 象 中 提取 包装 集 并 将 其 作为 DOM 元 素 的 JavaScript 数组 来 返回 。 
相反 ， 如 果 传 递 一 个 index 参数 , 它 将 返回 在 包装 集中 指定 的 从 0 开始 计数 的 位 置 处 的 DOM 

Var firstImage = $("1mg") [0]; 

请 注意 ，get 函数 (以 及 索引 ) 会 中 断 jQuery 的 连贯 性 ， 因 为 它 会 返回 DOM 对 象 或 DOM 
对 象 的 数组 。 你 不 能 进一步 将 jQuery 函数 应 用 于 get 调用 的 结果 。 

包装 集 上 还 有 更 多 可 用 的 操作 ， 其 中 许多 你 都 可 以 通过 插入 方式 来 添加 。 
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11.2.2 ”选择 器 

查询 是 用 选择 器 来 描述 的 。 选 择 器 就 是 一 个 表达 式 ， 在 经 过 正确 的 计算 后 ， 会 选择 一 个 
或 多 个 DOM 元 素 。 在 jQuery 中 ， 你 有 三 种 基本 类 型 的 选择 器 :基于 ID 的 选择 器 、 层 县 样 
式 表 (CSS) 和 标签 名 称 。 此 外 , 选择 器 可 以 从 使 用 特 设 运算 符 联 合 的 多 个 更 简单 选择 器 的 组 合 
中 产生 。 在 这 种 情况 下 ， 可 以 使 用 复合 选择 器 。 

1. 基本 选择 器 

ID 选择 器 会 通过 ID 来 选取 DOM 元 素 。ID 选择 器 通常 只 会 选择 一 个 元 素 ， 除 非 页 面 中 
有 多 个 元 素 共 享 一 个 相同 的 卫 一 一 这 一 条 件 违背 了 HIML DOM 标准 ， 但 这 在 现实 情形 中 并 
非 不 常见 。 下 面 是 ID 选择 器 的 语法 : 


// Select all elements in the context whose ID 1s Buttonl 
$ ("#Buttonl"™.) 


最 有 前面 的 # 付 号 指示 jQuery 如 何 解 释 跟随 其 后 的 文本 。 
基于 CSS 的 选择 器 会 选取 共享 指定 CSS 类 的 所 有 元 素 。 其 语法 如 下 : 


// Select all elements in the context styled with the specified CSS class 
$s (".header") 


在 这 个 例子 中 ， 最 前 面 的 圆 点 () 符 号 会 引导 jQuery 将 后 面 的 文本 解释 成 CSS 样式 名 称 。 

最 后 ， 基 于 标签 的 选择 器 会 选取 带 有 指定 标签 的 所 有 元 素 ， 比 如 所 有 <img> 标 签 、 所 有 
<div> 标 签 ， 或 者 你 指定 的 任何 标签 。 在 下 面 的 例子 中 ， 选 择 器 由 普通 标签 名 称 组 成 一 一 在 最 
前 面 不 需要 符号: 


// Select all IMG elements in the context 
S ( Ny 1mg" ) 


如 前 所 述 ， 你 还 可 以 串联 两 个 或 更 多 个 选择 器 来 组 成 更 特定 的 选择 器 。 
2. 复合 选择 器 


通过 多 个 运算 符 就 能 实现 串联 。 例 如 ， 空 格 会 选取 满足 第 二 个 选择 器 的 所 有 元 素 并 将 这 
些 元 素 作为 匹配 第 一 个 选择 器 的 元 素 的 子 代 元 素 。 下 面 是 一 个 示例 | 


// Select alLl anchors contained within a DIV 
S ("div = 


上 面 所 示 的 选择 右 在 功能 上 等 效 于 以 下 jQuery 表达 式 : 


Ss{("div "yy .find("™a™): 


第 11 章 有 效 的 JavaScript 


类 似 于 空格 ，> 运 算 符 会 选择 由 第 一 个 选择 器 匹配 的 元 素 的 直接 子 元 素 (并 不 是 所 有 子 代 


// All anchors direct child elements of a DIV 
Ss ("div > a"™) 


上 和 面 的 选择 器 在 功能 上 等 效 于 以 下 jQuery 表达 式 : 

$ ("div") .children ("a") 

选择 器 的 普通 串联 可 由 逻辑 AND 条 件 产 生 。 例 如 ， 请 思考 以 下 但 询 : 

$ ("div.header.highlight") 

它 会 选择 所 有 同时 使 用 标 头 类 和 高 亮 类 为 样式 的 <div> 元 素 。 

+ 运算 符 一 一 相 邻 运算 符 一 一 会 在 第 一 个 选择 器 选择 的 元 素 之 后 紧 接 着 选择 第 二 个 选择 
器 中 的 同 级 元 素 。 下 面 是 一 个 示例 : 


// All P immediately preceded by A 
S | 十 p") 


-运算 符 一 下 一 位 运算 符 一 -类似 于 +， 只 不 过 它 选择 的 是 紧 随 其 他 元 素 之 后 的 同 级 元 


// All P preceded by A 
5("a ~ p") 


作为 蔡 代 ， 通 过 使 用 逗号 ， 就 可 以 返回 由 复合 选择 器 查询 出 的 元 素 合集 。 在 运算 中 ， 运 
号 表示 逻辑 OR 选择 器 。 以 下 例子 会 选取 是 A 或 P 的 元 素 : 


// All A and all P 
S ("a p") 


除了 简单 运算 符 ， 可 以 使 用 筛选 问 。 旬 选 器 就 是 包含 一 些 自 定义 逻辑 以 进一步 限定 所 选 
元 素 的 特定 jQuery 表达 式 。 


3. 预定 义 筛选 器 


可 以 通过 在 位 置 、 内 容 、 特 性 和 可 见 性 上 应 用 筛选 器 来 进一步 改进 选择 器 。 筛 选 器 是 一 
种 内 置 函数 ， 被 应 用 于 由 基本 选择 器 返回 的 包装 集 。 表 11-1 列 出 了 jQuery 中 的 位 置 筛选 器 。 
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表 11-1 位 置 筛选 器 


-first 返回 匹配 上 的 第 一 个 DOM 元 系 

:last 返回 匹配 上 的 最 后 一 个 DOM 元 系 

-not(selector) 返回 不 匹配 指定 选择 右 的 所 有 DOM 元 系 

:even 返回 在 从 0 开始 计数 的 过 引 中 位 于 偶数 位 置 的 有 所 有 DOM 元 系 

:odd 返回 在 从 0 开始 计数 的 过 引 中 位 于 奇数 位 置 的 甩 有 DOM 元 系 
-eq(index) 返回 在 包装 集中 位 于 指定 从 0 开始 计数 的 位 置 的 DOM 元 系 
-gt(index) 返回 在 从 0 开始 计数 的 索引 中 位 置 大 于 指定 案 引 的 所 有 DOM 元 素 
:lt(index) 返回 在 从 0 开始 计数 的 索引 中 位 置 小 于 指定 案 引 的 所 有 DOM 元 素 
:header 退回 是 标 头 的 所 有 DOM 元 素 ， 比 如 HL、H2 等 

-animated 返回 当前 正 授 过 jQuery 库 中 菏 些 函数 进行 处 理 的 所 有 DOM 元 系 


表 11-2 列 出 的 所 有 人 澳 选 右 部 可 以 帮助 你 选 出 一 个 父 元 系 的 子 元 系 。 


表 11-2 子 筛 选 器 


nth-child(expression) | 返回 匹配 指定 表达 式 的 任意 父 元 素 的 有 所有 子 元 素 。 该 表达 式 可 以 是 一 个 寺 引 或 数 


列 (例如 ，3n+1)， 包 括 像 奇数 和 侦 数 这 样 的 标准 数列 


-first-child 返回 是 其 父 元 系 的 第 一 个 子 元 素 的 甩 有 元 素 
:last-child 返回 是 其 父 元 素 的 最 后 一 个 子 元 素 的 所 有 元 素 
:only-child 返回 是 其 父 元 素 的 唯一 一 个 子 元 素 的 所 有 元 素 


偶数 


一 个 功能 特别 强大 的 筛选 器 是 nth-child。 它 支持 大 量 的 输入 表达 式 ， 如 下 所 示 ; 


:nth—child(1index) 

:nth—child (even) 

:nth-child (odd) 

:nth-—-child (expresslion) 

第 一 个 格式 会 选择 源 选 择 器 中 所 有 HTML 元 素 的 第 n 个 子 元 素 。 相反 ， 如 果 指 定 奇数 或 
第 选 嚣 ， 则 会 返回 位 于 从 0 开始 计数 的 索引 的 奇数 或 侦 数 位 置 的 所 有 子 元 素 。 

最 后 ， 可 以 给 nth-child 师 选 右 提 供 一 个 数列 表达 式 ， 比 如 3n 表示 位 置 是 3 的 倍数 的 所 有 
。 以 下 选择 器 会 选取 一 个 表格 中 的 所 有 行 (标记 为 TableD)， 这 些 行 位 于 由 数列 3n+1 一 一 


旭 1、4、7 等 所 确定 的 位 置 : 
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#Tablel tr:nth-child (3n+1) 


表 11-3 列 出 了 用 于 根据 内 容 盘 选 元 素 的 表达 式 。 


-contalns(texf) 
-empty 
-has(selector) 


-parent 


表 11-3 内容 筛选 器 
描 述 
返回 包含 指定 文本 的 所 有 元 素 
返回 没有 子 元 素 的 所 有 元 素 
返回 至 少 包含 一 个 匹配 指定 选择 器 元 素 的 所 有 元 素 
返回 至 少 具有 一 个 子 元 素 的 所 有 元 素 


就 内 容 筛 选 右 而 言 ， 你 应 该 注意 HTML 元 素 中 的 任何 文本 痢 会 被 看 作 是 子 节 点 。 所 以 ， 
由 空 师 选 絮 选 择 的 元 系 束 没有 子 广 所 或 任何 文本 。 举 例 : <br > 标 俭 。 

一 个 流行 和 强大 的 利 选 器 类 别 是 特性 筛选 器 。 使 用 特性 痪 选 右 ， 你 就 可 以 选 出 指定 特性 
与 菜 值 具 有 指定 关系 的 HTML 元 素 。 表 11-4 列 出 了 在 jQuery 中 受 文 持 的 所 有 特性 筛选 器 。 


筷 选 器 
[attribute| 
[attribute = value| 


[attribute != value | 
[attribute ^= value| 
[attribute $= value| 
[attribute *= value| 


表 11-4 ”特性 径 选 器 

描 述 
返回 具有 指定 特性 的 所 有 元 素 。 该 筛选 器 会 
返回 指定 特性 被 设置 为 指定 值 的 所 有 元 素 
返回 其 指定 特性 具有 的 值 与 指定 值 不 同 的 所 有 元 素 
返回 其 指定 特性 具有 的 内 容 以 指定 值 开头 的 所 有 元 素 
返回 其 指定 特性 具有 的 内 容 以 指定 值 结尾 的 所 有 元 素 
返回 其 指定 特性 具有 的 内 容 包含 指定 值 的 所 有 元 素 


选择 元 素 而 不 管 其 特性 值 是 什么 


你 还 可 以 通过 将 两 个 或 更 多 特性 师 选 器 并 排放 置 来 串联 特性 和 是 选 右 ， 如 以 下 示例 所 示 : 


Var elems 


$s ("td[align=right] [valign=top]"™); 


该 返回 集 包 括 所 有 水 平 对 齐 徘 右 及 垂直 对 齐 拓 顶 部 的 <td> 元 系 。 
下 面 的 表达 式 要 复杂 得 多 ， 损 示 jQuery 选择 占 强 大 的 力量 及 姑 活 性 ， 因 为 该 表达 式 组 


#Tablel tr:nth-child(3n+1) :has (td[align=right]) td:odd 


在 元 素 Tablel 的 正文 内 , 选择 所 有 位 于 1、4、7 等 位 置 的 <tr> 元 素 。 接着 , 只 保留 <td> 元 素 存 在 特性 align 
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等 于 right 值 的 表格 行 。 此 外 ， 剩 下 的 行 中 ， 只 保留 索引 为 奇数 的 列 上 的 单元 格 。 


其 结果 是 由 <td> 元 素 组 成 的 包装 集 。 

最 后 ， 还 有 几 个 竹 选 器 是 与 元 素 可 见 性 有 关 的 。:visible 科 选 器 会 返回 当前 可 见 的 所 有 元 
素 。:hidden 科 选 器 会 返回 当前 从 视图 中 隐藏 的 所 有 元 素 。 该 包装 集 还 包括 类 型 特性 等 于 
“hidden” 的 所 有 输入 元 素 。 

4. filter 与 find 的 对 比 

要 进一步 限定 一 个 查询 ， 可 以 在 包装 集 上 使 用 find 或 filter 函数 。 当 然 ， 它 们 并 不 相同 。 

filter 国 数 会 探 得 当前 的 包装 集 以 匹配 元 素 ， 绝 不 会 检查 DOM 以 获取 子 代 元 素 。 相 反 ， 
find 函数 会 对 包装 集 内 部 的 每 个 元 素 进行 检查 以 获得 匹配 表达 式 的 元 素 。 不 过 ， 这 样 的 话 ， 
该 函数 会 探查 包装 集中 每 个 元 素 的 DOM。 

5. 包装 集 上 的 串联 操作 

jQuery 库 提供 了 各 式 各 样 的 函数 ， 可 以 将 它们 应 用 到 包装 集 内 容 上 (要 获得 一 个 完整 列 
表 , 只 能 借助 于 在 线 文 档 , 或 找到 一 本 深入 讨论 这 方面 内 容 的 书 )。 可 以 将 函数 调用 串联 起 来 ， 
因为 由 查询 返回 的 任何 包装 集 反 过 来 会 作为 男 一 个 jQuery 对 象 ， 以 便 进一步 人 查询。 例如， 以 
下 表达 式 束 能 正常 运行 : 

$s (selector) .hlde() .addClass ("hiddenElement™); 

上 述 表 达 式 首先 会 对 视图 隐藏 所 有 匹配 的 元 素 ， 然 后 为 每 一 个 元 系 添 加 一 个 指定 CSS 类 。 

可 以 将 操作 归 类 成 能 够 在 包装 集 上 执行 的 几 个 分 组 ， 如 表 11-5 中 所 摘 述 的 。 

表 11-5 包装 集 上 的 操作 


作 用 描述 
DOM 操作 创建 DOM 树 、 添 加 / 移 除 元 系 ， 或 修改 现 有 元 系 
绑 定 事件 将 处 理 程序 绑 定 和 解除 绑 定 到 由 DOM 元 素 发 起 的 事件 
样式 化 为 所 选 元 素 应 用 、 移 除 或 切换 CSS 类 并 得 到 或 设置 单个 CSS 属性 
可 见 性 使 用 过 渡 效 果 ( 例 如 渐变 ) 及 持续 时 间 显 示 和 隐藏 DOM 元 素 


此 外 , 在 jQuery 中 你 会 发 现 其 他 两 个 实用 分 组 一 一 缓存 和 Ajax 调用 一 一 它们 会 处 理 包 装 
集 的 内 容 ， 不 过 不 能 将 其 严格 地 看 作 是 包装 集 上 可 用 的 操作 。 


11.2.3 ”事件 
处 理事 件 在 J avaScript 编程 中 是 各 见 的 活动 。 ]Query 库 担 供 了 大 量 图 数 将 处 理 程 序 绑 定 


386 


第 11 章 ”有 效 的 JavaScript 


到 以 及 解除 绑 定 到 由 DOM 元 素 发 起 的 事件 。 

1. 绑 定 和 解除 绑 定 

bind 和 unbind 这 对 函数 用 于 将 回调 函数 附加 到 指定 事件 。 这 里 有 一 个 示例 ， 其 中 匹配 选 
择 器 的 所 有 元 素 都 将 为 click 事件 附加 相同 的 处 理 程序 : 

$ (selector) .bind("click", function() 1{ 

}); 

你 要 使 用 unbind 函数 来 将 当前 已 定义 的 处 理 程序 与 指定 事件 分 离 : 

S$ (selector) .unbind ("cl1ick™).:; 

请 注意 ，unbind 函数 并 不 会 移 除 那 些 通 过 onXXX 这 样 的 特性 直接 在 标记 中 插入 的 处 理 

jQuery 库 还 定义 了 不 少 直接 函数 来 绑 定 指 定 事 件 . 已 有 的 用 于 事件 的 配套 图 数 包 括 click、 
change、blur、focus、dblclick、keyup 等 。 以 下 代码 显示 了 如 何 将 处 理 程序 绑 定 到 click 事件 : 

$s (selector) .click (function() 1 

1); 

进行 不 带 回 调 的 调用 ， 相 同 的 事件 函数 会 产生 调用 当前 处 理 程序 的 效果 ， 如 果 该 处 理 程 
序 被 注册 过 的 话 。 例 如 ， 以 下 代码 模拟 了 用 户 单 击 指定 按钮 的 情况 : 

$s ("#Buttonl™) .click(); 

可 以 通过 使 用 trigger 函数 以 一 种 更 通用 的 方式 来 达到 相同 效果 : 

$ ("#Buttonl") .trigqger ("Click"™); 

事件 处 理 程序 会 接收 一 个 jQuery 内 部 对 象 一 一 Event 对 象 。 该 对 象 会 提供 一 个 用 于 事件 
的 统一 编程 接口 ， 该 接口 与 万 维 网 联盟 (W3C) 的 倡议 密切 相关 ， 并 且 它 解决 了 某 些 浏览 器 造 
成 的 轻微 不 同 实 现 所 引起 的 差异 性 问题 : 


$s ("#Buttonl™"™) .click (function(evt) I 
// Access information about the event 


// Return false 1if You intend to stop propagation 
return falses 


}); 
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Event 对 象 的 属性 特征 包括 鼠标 坐标 、 事 件 的 JavaScript 时 间 、 使 用 的 是 哪个 鼠标 按钮 ， 
以 及 事件 的 目标 元 素 等 。 


2. 动态 事件 绑 定 


动态 绑 定 是 jQuery 的 一 个 很 棒 的 特性 ， 通 过 它 可 以 在 整个 页 面 生命 周 期 中 保持 对 DOM 
元 素 指定 子 集 的 事件 绑 定 跟踪 。 换 句 话 说， 如 果 选 择 动态 绑 定 而 非 普 通 绑 定 ， 就 确保 了 任何 
动态 添加 的 能 匹配 选择 器 的 元 素 都 会 自动 附加 相同 的 处 理 程序 。 从 jQuery1.7 开始 ， 你 就 该 
通过 on 和 off 函数 来 操作 动态 绑 定 了 。 下 面 是 一 个 示例 : 


$ (document) .on ("click", ".specialButton "™, function() 1{ 

站 

所 有 用 specialButton CSS 样式 修饰 的 按钮 都 作为 click 事件 的 处 理 程序 附加 的 指定 函数 。 
要 停止 茶 些 元 素 的 动态 绑 定 ， 可 以 使 用 off 函数 : 


${(".specialButton™) .off ("click"™); 


使 用 on 和 bind( 或 指定 的 事件 函数 ， 比 如 click) 之 间 的 区 别 在 于 ， 使 用 on 函数 时 ， 任 何 
添加 到 页 面 的 以 及 用 specialButton 样式 修饰 的 新 的 DOM 元 系 都 会 目 动 添加 处 理 程 序 。 但 使 
用 bind 的 话 就 不 是 这 样 了 。 


注意 : 
如 果 使 用 的 jQuery 版 本 比 1.7 低 ， 就 要 使 用 live 和 die 方法 作为 on 和 o 任 的 替代 。 其 语 
法 稍 有 不 同 ， 因 为 live 方法 不 会 将 选择 器 用 作 参 数 。 相 反 它 会 直接 应 用 于 选择 器 。 


3. 准备 页 面 和 DOM 


在 客户 端 开 发 初期 ， 只 有 一 个 地 方 你 能 够 放置 网 页 的 初始 化 代码 : 在 窗口 对 象 或 <body> 
标签 上 的 onload 事件 中 。 页 面 一 完成 加 载 ，onload 事件 就 会 触发 一 一 也 就 是 说 ， 在 所 有 链接 
图 片 、CSS 样式 以 及 脚本 完成 下 载 之 后 。 不 过 ， 这 不 能 确保 此 时 DOM 已 经 被 完全 初始 化 并 
且 准 备 好 接受 指令 。 

DOM 中 的 document 根 对 象 公 开 了 一 个 只 读 的 readyState 属性 ， 这 就 是 为 了 让 你 获知 
DOM 的 当前 状态 并 获悉 何 时 你 的 页 面 准备 就 绪 ， 能 够 开始 执行 脚本 。 使 用 readyState 属性 是 
一 种 绝对 可 行 的 方式 ， 但 它 有 一 点 及 烦 。 为 此 ，jQuery 提供 了 其 目 己 的 ready 事件 ， 提 示 你 
什么 时 候 可 以 开始 在 框 染 中 进行 安全 调用 了 。 

<script type="text/Javascript"> 

5 (document) .Feady ( 
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function() 1{ 
alert ("I'm ready!™); 
}); 
</script> 
可 以 在 页 面 或 视图 中 拥有 多 个 ready 调用 。 指定 多 个 ready 调用 时 ,jQuery 会 将 指定 函数 
推送 到 内 部 堆栈 并 在 DOM 实际 准备 好 之 后 按 顺 序 对 其 进行 处 理 。 
ready 事件 仅 会 在 文档 级 别 触发 ， 你 不 能 为 单个 元 素 或 包装 集中 的 任何 元 素 集 合 定义 
该 事件 。 


注意 : 

onload 事件 是 在 HTML 和 所 有 辅助 资源 都 加 载 之 后 调用 的 。ready 事件 是 在 DOM 初始 
化 之 后 调用 的 。 这 两 个 事件 的 运行 顺序 可 以 随意 安排 。onload 事件 不 能 确保 页 面 DOM 已 加 
载 ; ready 事件 不 能 确保 所 有 资源 (比如 图 片 ) 已 经 加 载 。 


11.3 JavaScript 编程 特性 


如 今 ， 你 弟弟 将 JavaScript 用 于 某 些 客户 端 逻 辑 和 输入 验证 。 可 以 使 用 JavaScript 来 下 载 
远程 服务 器 的 数据 ， 实 现 类 似 Windows 的 效果 ， 如 拖 放 ， 用 于 缩放 、 用 于 模板 、 用 于 弹出 和 
图 表 效 果 、 用 于 本 地 数据 缓存 ， 以 及 用 于 管理 围绕 页 和 面 的 历史 记录 和 事件 。JavaScript 被 用 于 
大 的 代码 块 ， 这 些 代 码 块 具有 较 高 水 平 的 可 重用 性 ， 且 彼此 之 间 需 要 安全 地 隔离 。 

换 句 话说 ， 你 希望 你 的 JavaScript 代码 具备 可 维护 性 并 且 无 侵入 性 。 


11.3.1 无 侵入 性 代码 
多 年 来 ， 编 写 带 有 能 够 显 式 附加 到 JavaScript 事件 处 理 程序 的 客户 端 按钮 的 HIML 页 面 
非常 普遍 。 下 面 是 一 个 典型 示例 : 


<input type="button™ value="Click me" onclick="handleClick()" /> 

从 纯粹 功能 的 角度 看 ， 此 代码 没什么 问题 ， 它 会 如 预期 般 运 行 ， 当 用 户 单 击 按钮 时 运行 
handleClick 这 个 J avaScript 商 数 。 当 本 avaScript 仅 用 于 网 页 的 辅助 功能 时 ,在 很 大 程度 上 可 以 
接受 这 种 方式 ; 不 过 ， 当 有 大 量 JavaScript 代码 表示 页 面 或 视图 的 香 要 部 分 时 ， 束 难以 处 理 了 。 

1. 使 用 代码 来 设计 视图 样式 

“无 侵入 性 JavaScript” 这 一 表述 最 近 很 流行 , 它 是 指 最 好 个 要 在 HTML 元 素 与 JavaScript 

代码 之 间 使 用 显 式 链接 。 从 某 种 程度 上 说 ， 无 侵入 性 JavaScript 就 是 CSS 类 的 对 应 脚本 。 

使 用 CSS， 可 以 编写 普通 的 HTML 而 无 需 内 联 的 样式 信息 ， 还 可 以 通过 使 用 CSS 类 将 
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样式 添加 到 元 素 。 同 样 的 ， 当 DOM 就 绪 时 ， 可 以 避免 使 用 事件 处 理 程序 特性 (onclick、 
onchange、onblur 等 )， 并 使 用 单个 JavaScript 函数 来 附加 处 理 程序 。 和 下面 是 一 个 简明 但 有 效 
的 无 侵入 性 JavaScript 的 示例 : 


<script type="text/Javascript"> 
$ (document) .ready (function () f 
$s ("#BUuttonl™)} .bind (“click™, function () 1 
var date = new Date() .toDatestring(); 
alert (date); 
}); 
}); 
</script> 


<h2>Javascript Patterns</h2> 
<fieldset> 
<legend>#1 :: Click</legend> 
<input type="button™ id="Buttonl™ value="Today™" /> 


</fieldset> 
可 以 将 整个 <scrip 集 块 移动 到 一 个 单独 的 JavaScript 文件 并 保持 你 视图 的 整洁 与 可 读 性 。 


2. 无 侵入 性 JavaScript 的 实用 规则 


无 侵入 性 JavaScript 建立 了 一 个 基础 原则 一 一 任何 网 页 中 的 任何 行为 都 必须 是 可 注入 的 
依赖 项 并 且 不 是 一 个 构建 块 。 富 JavaScript 代码 是 由 处 理 人 逻辑 和 管理 用 户 界面 (UD) 的 代码 组 成 
的 。UI 逻辑 需要 知道 DOM 和 视图 的 结构 。 这 必然 会 创建 一 个 依赖 性 。 可 以 接受 这 样 的 依赖 
性 ， 但 如 果 绕 过 依赖 性 就 更 好 了 。 

限制 UI 依赖 性 影响 的 一 个 方法 是 使 用 模板 和 像 KnockoutJS 这 样 的 特 设 库 来 呈现 页 面 。 
可 以 在 http://knockoutjs.com 获得 更 多 有 关 Knockout]JS 的 信息 。 


11.3.2 ”可 重用 封装 和 依赖 性 


越 来 越 多 的 页 面 是 广泛 地 基于 JavaScript 的 ,造成 了 越 来 越 多 的 页 面 结 构 组 件 化 的 问题 。 
我 们 来 探讨 一 种 被 广泛 认可 的 在 JavaScript 中 封 淡 代码 的 方式 , 这 些 代 码 对 外 部 库 没有 依赖 性 。 


1. 名 称 空间 模式 


JavaScript 编程 的 指导 原则 是 将 相关 属性 一 一 包括 全 局 属性 一 一 分 组 到 容 右 中 。 当 多 个 肢 
本 文件 之 间 共 享 这 样 的 容器 时 ， 可 能 就 很 难 决 定 ( 以 及 强制 ) 哪 一 个 文件 承担 初始 化 容器 和 子 
对 象 的 职责 。 下 面 是 一 个 可 用 于 定义 全 局 容器 的 简单 语法 的 示例 。 


Var GLOBALS = GLOBALS || {}; 
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这 一 技巧 是 可 行 的 ， 但 当 你 有 几 个 鞭 套 对 象 需要 管理 时 ， 用 起 来 通 弟 会 很 肪 烦 。 这 时 名 
称 空间 模式 就 能 派 上 用 场 了 。 

名 称 空 间 模 式 由 一 段 代 码 构成 ， 它 针对 以 圆 点 分 开 的 字符 串 的 令 牌 (例如 C# 或 Java 名 称 
空间 ) 进 行 迭 代 并 确保 初始 化 对 象 的 正确 层次 结构 。namespace 函数 会 确保 代码 不 会 被 破坏 并 
跳 过 已 有 的 实例 。 这 里 有 一 些 示例 代码 : 


Var GLOBALS = GLOBALS || {}; 


GLOBALS .namespace = function (ns) 1 
Var objects = ns.split("."), 
parent = GLOBALS, 
startIndex = 0, 
lr 


// You have one GLOBALS object per app. This object already exlsts 1f you 
// can call this function. So you can safely lgnore the root of the namespace 
// 1if it matches the parent string. 
if (objects{[0] === "GLOBALS") 

startIindex = 1; 


// Create missing objects in the namespace string 


for (1L = startIindex; 1 < objects.length; I++) 1{ 
Var name = objects[startIindex]; 
1f (typeof parent [name] === "undefined") 
parent [name] = {}; 
parent = parent [name |] : 
} 
return parent; 
}; 
引用 namespace 函数 之 后 ， 随 后 你 就 能 放置 以 下 调用 : 
GLOBALS .namespace ("Widgets"); // GLOBALS has a Widgets property 


GLOBALS .namespace ("GLOBALS .Widgets"); // GLOBALS has a Widgets property 
这 两 个 调用 是 等 效 的 ， 并 且 都 能 保证 GLOBALS 具有 一 个 初始 化 的 Widgets 属性 。 思 考 
以 下 代码 : 


// GLOBALS has a Widgets property, and Widgets has a NewsBox property 
GLOBALS .namespace ("GLOBALS .Widgets .NewsBoX") ; 


namespace 函数 会 继续 友 代 并 同时 确保 Widgets 具有 NewsBox 属性 。 
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Ee 
管 此 处 所 示 的 实现 可 以 被 认为 是 比较 标准 的 ， 但 我 觉得 有 必要 为 Stoyan Stefanov 就 这 
本 以 及 模块 模式 一 书 给 予 我 的 启发 表示 感谢 。Stoyan 是 JavaScript Patterns(O’Reilly 
Media，2010) 这 一 优秀 书籍 的 作者 。 我 建议 想 要 进一步 详细 了 解 与 本 章 内 容 有 关 的 知识 的 人 
都 去 读 读 这 本 书 。 


2. 模块 模式 


模块 模式 提供 了 一 种 封装 自 包 含 代 码 块 的 方法 ， 借 助 该 方法 可 以 从 项 目 中 轻易 地 添加 或 
移 除 该 代码 块 。 这 个 模式 将 一 个 经 典 的 JavaScript 函数 封装 成 了 一 个 立即 执行 函数 ， 它 能 保 
障 数 据 的 私密 性 ， 并 确保 只 有 你 显 式 地 展示 为 公共 的 内 容 才 会 作为 公共 内 容 被 客户 端 实 际 感 
知 。 在 JavaScript 中 ， 立 即 执 行 函 数 是 内 联 定义 并 将 立即 执行 的 函数 。 其 语法 如 下 : 


( 
function(...) f 
// Body 
EF (aaa 
) 7 


让 我 们 使 用 模块 模式 来 构建 一 个 从 指定 源 抓 取 新 闻 的 自 包 含 部 件 。 假 设 你 将 下 面 所 有 的 
代码 都 保存 到 一 个 JavaScript 文件 : 


GLOBALS .namespace ("Widgets.News"); 
GLOBALS .Widgets.News = function () ({ 
Var localUrl = "...™, 
localWidget = "mm， 
localBuildWidget = function (items) 1{ 
Var numOfNews = items.length; 
1f (localSsettings.maxNews >0) 
numOfNews = Math.min (localsettings.maxNews, numOfNews); 


Var buffer = "<table rules='rows'>") 
for (var 1 = 0; 1 < numOfNews; 1++) { 
buffer += "<tr><td»>"™ + litems [1] .Title + "</td></tr>"; 
} 
buffer += “</table>"; 
localWidget = pbuffer; 
} ， 
localsettings = { 
maxNews: 2, 
autoRefreshEvery: 0 


上 > 
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return { 
load: function (selector, settings) f 
if (settings != null) 
localsettings = settings; 


$ .getJSON (localUrl]) 
-done (function (data) { 
localBuildWidget (data); 
$s (selector) .html (localWidget).; 
}); 
} ， 
getHtml: function () { 
return localWidget; 


} (00; 
该 代码 定义 了 一 个 逻辑 块 ， 其 中 包含 下 载 和 对 来 自 源 的 大 量 新 闻 进行 格式 化 所 需 的 所 有 


使 用 模块 模式 ， 你 要 返回 一 个 对 象 将 你 想 要 使 其 可 见 的 公共 API 展示 出 来 。 下 面 的 代码 
揭示 了 你 如 何 使 用 一 个 模块 : 

<sScript type="text/Javascript™ Src="QUT1 .Content 

("~/content/scripts/module-news.]5") "></script> 
<script type="text/Javascript"> 
GLOBALS .Widgets.News.1load("#twitter-box", {maxNews: 10});} 

</script> 

首先 链接 包含 部 件 的 单个 文件 ， 然 后 传递 合适 的 设置 对 其 初始 化 。 这 个 示例 中 的 部 件 得 
到 了 UI 的 jQuery 选择 器 ， 该 部 件 会 在 UI 上 进行 图 形 化 变更 一 一 具体 来 说 ， 该 部 件 会 在 UI 
上 插入 市 有 所 选 新 闻 列 表 的 HTML 表格 。 

对 于 模块 模式 的 实现 ， 名 称 空间 模式 并 非 是 必须 的 ， 但 使 用 名 称 空间 模式 能 起 到 很 大 的 
帮助 。 
11.3.3 加载 脚 本 和 资源 


网 页 中 的 脚本 越 来 越 多 地 意味 着 有 越 来 越 多 的 脚本 文件 要 下 载 。 这 不 久 可 能 会 变 成 一 个 
严重 的 问题 并 需要 进行 处 理 。 当 页 面 有 几 个 脚本 的 时 候 ， 浏 虎 郁 可 以 操作 的 并 行 处 理 能 力 融 
会 显著 降低 。 这 样 一 来 页 面 的 加 载 时 间 也 就 相应 变 大 了 。 我 们 来 看 看 个 中 缘由 。 


1. 下 载 总 是 同步 进行 的 
HTTP/1.1 规范 建议 浏览 器 不 要 同时 从 每 个 主机 名 下 载 两 个 以 上 的 组 件 。 然 而 ， 这 对 于 脚 
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本 文件 是 绝对 行 不 通 的 : 浏览 左 总 是 同步 下 载 脚本 文件 ， 并 且 一 次 只 下 载 一 个 。 其 结 末 就 是 ， 
总 的 下 载 时 长 至 少 等 于 下 载 单 个 文件 所 需 的 时 长 之 和 ， 且 更 糟 的 可 能 是 ， 下 载 一 个 脚本 文件 
时 浏 贤 占 处 于 空 内 状态。 页面 呈现 只 有 在 脚本 文件 下 载 、 解 析 并 执行 完成 后 才 会 继续 进行 。 

浏览 器 实现 同步 下 载 的 主要 原因 是 保障 安全 性 。 实 际 上 ， 脚 本 文件 总 是 可 能 会 包括 有 像 
JavaScript 立即 执行 函数 或 document.write 这 样 的 会 修改 当前 DOM 状态 的 指令 。 


2. 底部 脚本 


要 改善 页 面 加 载 性 能 ， 可 以 使 用 一 个 简单 的 技巧 ， 也 就 是 将 脚本 文件 的 所 有 链接 移动 到 
页 面 的 底部 ， 放 在 </body> 标 签 之 前 。 当 你 这 样 处 理 的 时 候 ， 浏 览 器 就 不 需要 中 断 页 面 呈 现 过 
程 来 加 载 脚本 了 。 然 后 浏览 器 就 可 以 尽 可 能 快 地 提前 显示 页 面 视图 了 。 

尽管 手动 将 脚本 放置 到 底部 是 最 安全 的 方式 ， 但 有 另 一 个 选项 让 你 以 声明 形式 进行 设置 
并 无 须 借 助 编写 或 导入 特 设 的 JavaScript 代码 : 这 就 是 defer 特性 。 


<SCript src="..." defer="defer"></script> 


defer 特性 是 在 HTML 4 规范 中 引入 的 , 它 会 指示 浏览 器 是 否 能 将 脚本 加 载 延 运 到 页 面 处 
理 结束 时 进行 。 用 defer 特性 修饰 的 <scrip 亿 标签 会 隐 式 表明 ， 该 脚本 不 会 进行 任何 直接 的 文 
档 写 操作 ， 并 且 将 其 放 在 结束 时 加 载 是 安全 的 。defer 特性 的 作用 类 似 于 HTML5 规范 中 的 
async 特性 。 


3. 处 理 静 态 文 件 


Web 开发 的 指导 原则 规定 ， 在 你 消除 了 像 脚 本 、 样 式 表 以 及 图 片 这 样 的 静态 文件 对 性 能 
产生 的 不 民 影 响 之 后 ， 差 不 多 就 完成 了 优化 工作 。 有 两 种 主要 方式 来 最 小 化 静态 资源 的 下 载 
时 长 ， 且 两 者 并 不 相互 排斥 。 

最 显而易见 的 技巧 是 减 小 要 下 载 的 文件 的 大 小 。 第 二 个 最 明显 的 技巧 是 完全 不 要 下 载 它 
们 。 在 详细 介绍 之 前 ， 我 事先 声明 ， 这 些 优化 技巧 应 该 在 你 完成 开发 之 后 进行 。 如 果 在 开发 
过 程 中 应 用 这 些 技巧 ， 则 大 多 数 技巧 只 会 给 你 融 来 挫折 感 并 拖累 你 的 进度 。 

减 小 可 下 载 文 件 的 大 小 意味 着 压缩 其 内 容 , 浏 览 器 会 通过 Accept-Encoding 标 头 通知 Web 
服务 器 它们 所 文 持 的 压缩 类 型 。 第 8 章 “ 目 定义 ASPNET MVC 控制 器 ”揭示 出 , 在 ASPNET 
MVC 中 可 以 将 合适 的 啊 应 标 头 添加 到 任何 控制 右 操 作 ， 并 且 指 示 Web 服务 器 为 该 啊 应 使 用 
受 文 持 的 编码 。 还 可 以 在 Web 服务 器 级 别 为 静态 资源 直接 开 司 压缩 。 值 得 注意 的 是 ， 你 不 应 
对 那些 已 经 自行 压缩 过 的 文件 使 用 GZIP 压缩 (或 者 deflate 压缩 )。 例 如 ， 你 不 应 该 对 JPEG 图 
片 进行 GZIP 压缩 。 尽 管 GZIP 压缩 能 缩减 约 50% 的 大 小 ， 但 它 对 已 经 压缩 过 的 资源 作用 不 
大 ， 并 且 会 浪费 更 多 的 CPU 功 耗 。 

第 二 个 要 考虑 的 特性 是 浏览 器 缓存 。 静 态 资源 之 所 以 被 称 为 静态 ， 就 是 因为 它们 不 会 频 
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繁 变更 。 所以， 你 为 何 还 要 对 其 反复 下 载 呢 ?通过 为 你 的 静态 资源 分 配 一 个 很 长 的 存续 期 ( 通 
过 Expires 响应 标 头 )， 你 就 能 避免 浏览 器 频繁 下 载 这 些 资源 。 同 样 地 ， 也 可 以 在 Web 服务 器 
级 别 为 静态 资源 进行 存续 期 分 配 , 并 通过 Response 对 象 以 编程 方式 为 动态 处 理 的 资源 进行 存 
续 期 分 配 。 

在 这 方面 ， 内 容 分 发 网 络 (CDN) 是 有 用 的 ， 因 为 它 能 提高 浏览 器 缓存 已 经 包含 一 个 资源 
的 似 然 性 (likelihood)， 这 是 由 于 该 资源 可 能 已 经 由 使 用 相同 CDN 的 其 他 站 点 使 用 相同 URL 
进行 了 引用 。 请 注意 ， 放 置 一 个 只 有 一 个 应 用 程序 使 用 的 CDN 文件 ， 不 会 让 你 受益 太 多 。 


注意 : 

还 有 另 一 个 选项 来 抵消 静态 资源 的 开销 ， 就 是 将 那些 资源 放置 在 另 一 台 被 优化 过 以 返回 
静态 内 容 的 服务 器 上 。 或 者 ， 你 也 许可 以 使 用 像 Varnish(http://www.varnish-cache.org) 这 样 的 
反 向 代理 工具 来 从 各 种 服务 器 上 收集 图 片 ， 并 且 将 其 当 作 从 该 代理 处 原生 的 资源 来 返回 。 通 
过 在 CDN 或 网 站 之 前 使 用 反 向 代理 ， 你 就 能 在 降低 静态 文件 的 请 求 方 面 得 到 显著 收益 。 


4. 使 用 图 片 拼合 


为 了 改进 图 片 的 提供 服务 ， 可 以 考虑 使 用 图 片 拼 合 。 图 片 拼 合 就 是 由 多 个 图 片 组合 而 产 
生 的 单个 图 片 。 构 成 图 片 会 在 形成 新 图 片 的 过 程 中 并 排 保存 ， 如 图 11-1 所 示 。 


图 11-1 用 作 图 片 拼合 的 组 合 图 片 


在 页 面 中 ， 你 要 使 用 <img> 标 签 来 引用 整体 图 片 ， 并 通过 使 用 特定 CSS 样式 来 选择 该 图 
片 中 你 想 使 用 的 部 分 。 例 如 , 下面 是 你 需要 用 来 为 图 11-1 所 示 的 分 段 呈现 可 单 击 按钮 的 CSS: 


-Sl1gnup—link 


{ 
width: 175px; 
height: S56px; 
background-image: url(/images/loginsprite.png); 
background-position: -0PX Opx; 
background—repeat: no-repeat; 

} 


.Slgnup-link:hover 
{ 

background-position: -177PX Opx; 
} 


.Silgnup-link:active 
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background-—position: ~—354px Opx; 

} 

background-position 表示 呈现 该 图 片 的 起 始 相 对 位 置 。 例 如 ， 当 鼠标 悬 停 在 该 图 片上 时 ， 
浏览 器 会 跳 过 起 始 位 置 177 个 像素 再 开始 呈现 图 片 。 这 意味 着 第 一 个 按钮 不 会 显示 ， 并 且 图 
片 拼合 呈现 的 部 分 正好 就 是 高 亮 按 钮 (正如 你 在 图 11-1 中 所 看 见 的 ， 为 清晰 可 见 ， 我 添加 了 1 
个 像素 的 空白 线 ， 这 就 是 在 计算 位 置 时 你 必须 跳 过 一 个 像素 的 原因 )。 其 实际 效果 是 ， 你 只 会 
具有 一 个 图 片 、 只 有 一 次 下 载 、 一 个 缓存 图 片 以 及 对 用 户 显 示 的 酷 炫 效果 (参见 图 11-2)。 


起 http://ocalhost6105/# 


[Bromers x 


JavasScript Fun Login or sign up 


R105% ~ 
= x | 
{= (全 区 http://localhost6105/# | 


|@romerage x 


JavasScript Fun 


< 辕 http://localhost6105/# 


ET 


JavaScript Fun 


图 11-2 运行 中 的 图 片 拼合 
11.3.4 ”捆绑 和 缩小 


随 着 网 页 持续 提供 不 断 丰 富 的 可 视 化 内 容 ， 下 载 像 CSS、 脚 本 和 图 片 这 样 的 相关 资源 的 
开销 就 会 显著 增加 。 可 以 肯定 的 是 ， 在 很 大 程度 上 上， 这些 资 源 都 会 由 浏览 器 在 本 地 缓存 ， 然 
而 初始 的 占用 空间 就 真 的 很 难 维持 了 。 对 于 脚本 和 CSS 文件 来 说 ，GZIP 压缩 可 以 与 捆绑 和 
缩小 相 结 合 。 

捆绑 就 是 将 者 干 不 同 资 源 捆 在 一 起 成 为 单个 可 下 载 资源 的 过 程 。 例 如 ， 一 个 捆绑 可 能 由 
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多 个 JavaScript 或 CSS 文件 构成 。 纵 小 是 应 用 到 单个 资源 的 转换 。 有 具体 来 说 ， 缩 小 就 是 以 某 
种 不 更 改 预期 功能 性 的 方式 从 基于 文本 的 资源 中 移 除 所 有 不 必要 的 字符 。 这 意味 着 移 除 注释 、 
空白 字符 以 及 新 行 ; 一 般 来 说 ， 通 常 添加 的 所 有 字符 都 是 为 了 具备 可 读 性 ， 但 它们 会 占据 空 
则 并 且 不 会 真 的 用 于 实现 功能 性 目的 。 

可 以 同时 应 用 捆绑 和 缩小 ， 但 它们 仍然 是 独立 的 处 理 过 程 。 根 据 需 求 不 同 ， 可 以 决定 只 
创建 捆绑 或 只 缩小 个 别 文件 。 不 过 ， 通 沼 在 生产 站 点 上 没有 理由 不 去 捆绑 和 缩小 所 有 的 CSS 
和 JavaScript 文件 。 但 是 在 调试 时 ， 情 况 就 完全 不 同 了 : 一 个 缩小 或 捆绑 的 资源 很 难 阅 读 和 
逐步 调试 ， 所 以 你 绝 不 会 想 在 调试 时 启用 捆绑 和 缩小 。 

市 面 上 存在 大 量 的 框架 提供 捆绑 和 缩小 服务 ， 这 些 服务 具 有 轻微 不 同 的 可 扩展 性 级 别 和 
不 同 的 特征 集 。 我 相信 ， 在 很 大 程度 上 ， 它 们 都 提供 了 相同 的 功能 ; 所 以 ， 选 择 哪个 框架 就 
只 是 个 人 喜好 问题 而 已 。 如 果 正 在 编写 一 个 ASPNET MVC 应 用 程序 ， 捆 绑 和 缩小 的 原生 选 
项 就 是 微软 ASPNET Web 优化 框架 ， 它 是 通过 一 个 NuGet 包 提 供 的 。 


1. 捆绑 相关 资源 

通 第 ， 需 要 在 globalasax 中 以 编程 方式 创建 捆绑 。 按 照 ASPNET MVC 约定 ， 你 要 在 
App_Start 文件 夹 中 创建 一 个 BundleConfig 类 ， 并 从 中 公开 一 个 静态 初始 化 方法 ， 如 下 所 示 : 

BundleConfig.ReglisterBundles (BundleTable.Bundles); 

一 个 捆绑 仅仅 就 是 一 个 文件 (通常 是 样式 表 或 脚本 文件 ) 集 合 而 已 。 下 面 是 你 需要 用 来 将 
两 个 CSS 文件 组 合成 单个 下 载 的 代码 : 


public class BundleConfig 


{ 
public static vold RegisterBundles (BundleCollection bundles) 
{ 
bundles.Add (new Bundle ("~/all-css") .Includel 
"~/content/styles/sitel .css", 
"~/content/styles/site2.css")); 
BundleTable.EnableOptimizations = true; 
} 
} 


你 创建 了 一 个 新 的 Bundle 类 , 并 且 将 用 于 从 视图 内 部 引用 捆绑 的 虚拟 路 径 传递 给 构造 函 
数 。 为 了 把 CSS 文件 关联 到 捆绑 ， 你 要 使 用 Include 方法 。 该 方法 采用 了 一 个 代表 虚拟 路 径 
的 字符 串 数 组 。 可 以 显 式 指 明 CSS 文件 , 正如 上 面 的 例子 , 或 者 也 可 以 指明 一 个 模式 字符 串 ， 
如 下 所 示 : 
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bundles.Add (new Bundle ("~/al1L-css") .Include("~/content/styles/*.css"); 


捆绑 是 优化 的 一 个 形式 ; 因此 ， 它 主要 用 于 生产 环境 中 的 站 点 。EnableOptimization 属性 
是 在 生产 环境 中 将 捆绑 设置 为 局 用 的 便捷 方式 。 请 注意 ， 在 捆绑 被 显 式 开 局 前 ， 它 都 不 会 
生效 。 


2. 摘 绑 脚本 文件 


捆绑 类 在 处 理 CSS 或 JavaScript 文件 方面 并 没有 什么 不 同 。 不 过 ，BundleCollection 类 有 
两 个 特性 对 于 捆绑 脚本 文件 特别 有 用 : 顺序 和 忽略 列表 。 

BundleCollection 类 具有 一 个 IJBundleOrderer 类 型 的 名 为 Orderer 的 属性 。 正 如 其 名 称 所 
表明 的 ， 排 序 器 就 是 一 个 负责 确定 实际 顺序 的 组 件 ， 你 要 在 其 中 指定 用 于 下 载 的 被 捆 绑 的 文 
件 顺 序 。 默 认 的 排序 器 是 DefaultBundleOrderer 类 。 这 个 类 会 按照 通过 FileSetOrderList 属性 
设置 的 顺序 捆绑 文件 ，FileSetOrderList 是 BundleCollection 的 男 一 个 属性 。FileSetOrderList 
属性 被 设计 为 一 个 BundleFileSetOrdering 类 的 集合 。 这 些 类 中 的 每 一 个 都 会 为 文件 定义 一 个 
模式 (例如 jquery- 蚊 ， 并 且 BundleFileSetOrdering 实例 的 顺序 会 确定 捆绑 中 文件 的 实际 顺序 。 
例如 ， 基 于 默认 配置 ， 所 有 的 jQuery 文件 就 总 是 会 在 Modernizr 文件 之 前 被 捆绑 。 文 件 的 常 
见 分 组 (比如 jQuery、 jQuery UI 和 Modernizr) 的 顺序 十 预定 义 好 的 ; 可 以 随意 以 编程 方式 重症 
和 喝 新 顺序 。 


注意 : 

DefaultBundleOrderer 类 对 于 CSS 文件 的 影响 较为 有 限 但 并 非 没 有 。 如 果 在 你 的 网 站 中 
有 reset.css 和 /或 normalize.css 文件 ， 这 些 文件 就 会 在 所 有 其 他 CSS 文件 前 自动 捆绑 ， 而 且 
reset.css 总 是 位 于 normalize.css 之 前 。 使 用 重 置 (reset)/ 标 准 (normalize) 样 式 表 的 目的 在 于 ， 为 
所 有 HTML( 重 置 ) 和 HTMLS( 标 准 ) 元 系 提供 样式 特性 的 标准 集 ， 以 便 你 的 页 面 不 会 继承 特定 
于 浏览 器 的 设置 ,比如 字体 、 大 小 、 边 距 。 尽管 有 些 推荐 内 容 同 时 存在 于 这 两 个 CSS 文件 中 ， 
但 实际 内 容 取 决 于 你 。 如 果 在 你 的 项 目 中 存在 有 具有 这 些 名 称 的 文件 ， 则 ASPNET MVC 就 会 
尽力 确保 它们 在 其 他 文件 之 衣 捆 绑 。 


如 果 想 要 重 写 默认 的 排序 器 和 忽略 预定 义 的 捆绑 文件 集 顺 序 ， 有 两 种 选择 。 第 一 ， 可 以 
创建 目 己 的 排序 器 ， 它 会 基于 每 个 捆绑 运行 。 下 面 是 一 个 忽略 预定 义 顺 序 的 示例 : 


public class SimpleOrderer : IBundleOrderer 
{ 
public IEnumerable<FileInfo> OrderFiles( 
BundleContext context, IEnumerable<FileInfo> files) 
{ 
return files; 


} 
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} 
要 像 如 下 所 示 这 样 使 用 它 : 


Var bundle = new Bundle("~/all-css"); 
bundle.Orderer = new SimpleOrderer () ; 


此 外 ， 可 以 通过 使 用 以 下 代码 来 重 置 所 有 顺序 : 
bundles.ResetAl]l 1() ， 


在 这 个 例子 中 ， 使 用 默认 排序 器 或 之 前 所 示 的 简单 排序 器 的 效果 是 相同 的 。 但 是 ， 需 要 
注意 的 是 ，ResetAll 还 会 重 置 所 有 当前 脚本 的 顺序 。 

第 二 个 值得 注意 的 特性 是 忽略 列表 。 它 是 通过 BundleCollection 类 的 IgnoreList 属性 来 定 
义 的 ， 忽 略 列表 定义 了 用 于 匹配 文件 字符 串 的 模式 ， 这 些 文件 是 所 选 的 要 包含 在 捆绑 中 但 却 
应 该 被 忽略 的 。 忽略 列表 的 主要 好 处 是 , 可 以 在 捆绑 中 指定 *.js, 但 可 以 使 用 忽略 列表 来 跳 过 ， 
比如 说 *.vsdoc.js 文件 。IgnoreList 的 默认 配置 顾及 到 了 大 多 数 第 见 情 况 (包括 *.vsdoc.js 文件 )， 
同时 又 让 你 能 够 进行 自 定义 。 


3. 添加 缩小 


Bundle 类 的 重心 只 是 将 多 个 资源 打包 到 一 起 , 以 便 它 们 能 和 被单 次 下 载 捕获 和 绥 存 。 不 过 ， 
出 于 可 读 性 目的 , 样式 表 和 脚本 文件 都 被 填充 有 空格 和 新 行 字符 。 可 读 性 对 人 们 (以 及 在 调试 
时 ) 很 重要 ， 但 这 对 于 浏览 器 从 来 就 不 是 问题 。 下 面 的 字符 串 是 一 个 能 被 浏览 右 完 美 接 受 的 
CSS 缩小 版 本 示例 。 如 你 所 见 ， 它 不 包含 任何 额外 字符 。 

html,body{font-famlly:'segoe ulil';font-size:1.S5em;)} 

html,body{background—color:#111l;color:#48dlcc]} 

你 要 如 何 将 缩小 添加 到 CSS 和 JavaScript 文件 呢 ? 只 要 将 Bundle 类 修改 成 StyleBundle 
或 ScriptBundle 关 就 行 了 。 这 两 个 类 都 怀 人 的 简单 : 它们 继承 目 Bundle， 并 且 仅 由 一 个 不 同 
的 构造 函数 构成 。 

public ScrlIptBundle (strlnd virtualPath) 

: base (virtualPath, new IBundleTransform[] { new JsMinify() }) 

{ 

} 

Bundle 类 具有 一 个 接收 IBundleTransform 对 象 列表 的 构造 函数 。 这 些 转 换 会 一 个 接 一 个 
地 应 用 到 内 容 。 ScriptBundle 关 仅 状 加 JsMinify 转换 器 。 而 StyleBundle 类 添加 CssMimtfy 转换 
器 。CssMinify 和 JsMinify 都 是 ASPNET MVC 4 的 默认 缩小 器 ， 并 且 都 是 基于 WebGrease 框 
架 的 。 无 须 多 说 ， 如 果 想 要 切换 到 一 个 不 同 的 缩小 器 ， 你 需要 做 的 就 是 创建 它 对 应 的 类 一 一 
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IBundleTransform 的 实现 一 一 并 通过 构造 函数 传递 它 即 可 。 
11.4 “本 重 小 结 


人 们 豆 欢 通过 Web 使 用 交互 陈 应 用 程序 。 出 于 各 种 原因 ， 编 与 这 些 应 用 程序 的 最 音 用 方 
式 仍 然 是 JavaScript。 作 为 生命 力 硕 强 的 语言 ，JavaScript 在 Adobe Flash 和 微软 Silverlight 出 
现 之 后 仍 幸 运 地 存活 了 下 来 。 尽 管 Flash 和 Silverlight 仍 用 于 一 些 Web 应 用 程序 中 ， 但 目前 
它们 已 经 没有 机 会 吃 掉 JavaScript 了 。 

最 初 引入 JavaScript 是 为 了 赋 子 Web 作者 在 HIML 页 面 中 集成 某 些 简单 逻辑 和 操作 的 能 
力 。JavaScript 的 设计 目的 并 非 是 成 为 前 治 的 编程 语言 。JavaScript 的 设计 受到 许多 语言 的 影 
啊 ， 但 其 主要 因素 是 简易 性 。 它 需要 额外 的 工具 来 支持 超 出 修改 DOM 元 素 特性 的 开发 ， 这 
也 就 是 像 业 界 标准 jQuery 以 及 KnockoutJS 和 AngularJS 所 适用 的 地 方 。 

在 第 12 章 “ 让 网 站 对 移动 端 友好 ”中 ， 我 们 要 进入 一 种 客户 端的 、 密 集 JavaScript 应 用 
程序 类 型 的 开发 : 即 单 页 面 应 用 程序 。 


利 12 草 


让 网 站 对 移动 响 友 好 


不 要 走 在 我 前 面 ， 因 为 我 可 能 不 会 跟随 。 不 要 走 在 我 后 面 ， 因 为 我 可 能 不 会 引路 。 请 走 
在 我 旁边 ， 做 我 的 朋友 . 
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说 起 软件 ， 移 动 端 一 词 第 党 与 特定 平台 一 一 如 苹果 公司 的 10S 平台 、Windows Phone 或 
Android 平台 一 一 的 本 地 应 用 程序 联系 在 一 起 . 这 里 的 共识 实际 上 是 你 应 该 让 应 用 程序 适用 于 
某 些 平台 ， 并 确保 可 以 在 智能 手机 和 (迷你 ) 平 板 电脑 上 和 舒适 地 浏览 网 站 。 最 新 的 设备 可 以 毫 
无 问题 地 显示 几乎 所 有 的 网 站 。 这 导致 许多 高 管 把 移动 端 看 成 是 处 理 一 些 本 地 应 用 程序 的 问 
题 ， 而 宛 全 忽视 了 移动 互联 网 的 做 妙 之 处 。 

我 的 看 法 并 非 如 此 。 我 不 讨论 是 否 使 用 (或 不 使 用 ) 移 动 应 用 程序 ， 因 为 该 问题 太 过 特定 
于 业务 ， 不 便 沉 统 探 讨 。 但 是 ， 我 确实 认为 提供 一 个 对 移动 端 友好 的 网 站 的 确 非 彰 重 要 。 更 
确切 地 说 ， 我 认为 ， 尽 管 任何 一 家 公司 都 可 以 满足 于 有 一 个 可 供 显 示 且 能 够 在 智能 手机 上 浏 
览 的 网 站 ， 但 是 提供 了 移动 端 优化 设计 的 网 站 用 户 体验 (UX) 比 仅仅 捏 拉 缩 放 来 填写 表单 和 疯 
读 资 讯 要 好 太 多 了 。 

在 这 一 半 ， 你 将 自 完 回顾 一 些 有 助 于 网 站 对 移动 器 友 好 的 拉 术 。 这 些 拉 术 中 当然 包括 
HTML5， 还 进一步 包括 啊 应 式 网 页 设计 (RWD)， 并 涉及 一 些 特定 的 JavaScript 框架 ， 如 
jQueryMobile 和 等。 接着， 你 将 了 解 在 付 诸 实践 时 你 所 面临 的 具体 挑战 。 你 会 看 到 如 何 把 两 个 
不 同 的 站 点 (桌面 和 移动 端的 ) 联 系 在 一 起 ， 以 便 它 们 在 用 户 眼 里 显示 为 同一 个 网 站 。 第 13 章 
“构建 用 于 多 种 设备 的 站 点 ”会 将 该 讨论 深入 下 去 , 并 解决 多 设备 网 站 设计 的 所 有 重点 问题 。 


12.1 在 站 点 上 局 用 移动 端 技 术 
移动 端 用 户 在 UX 方面 有 着 较 高 的 期 望 值 ; 他 们 希望 应 用 程序 提供 完整 的 用 户 界 面 (UD， 


类 似 于 流行 设备 (比如 iPhone) 的 那 种 ， 它 能 基于 触摸 并 且 由 常见 小 部 件 填 充 ， 比 如 选择 列表 
和 iPhone 风格 的 切换 开关 。 这 些小 部 件 并 不 作为 HTML 的 本 地 元 素 存 在 (尚未 如 此 ， 但 预计 
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很 快 将 出 现 )， 且 必须 通过 每 一 次 使 用 服务 器 端 控件 输出 混合 的 JavaScript 和 标记 来 模拟 。 

其 底线 是 ， 创 建 一 个 能 有 效 利 用 HTML、 层 登 样式 表 (CSS) 和 JavaScript 的 普通 网 站 是 一 
回 事 ; 但 要 创建 一 个 看 起 来 像 或 最 起 码 表现 得 像 本 地 应 用 程序 的 引 人 注 目的 移动 网 站 却 是 妨 
一 回 事 了 。 

一 般 说 来 , 移动 浏览 器 都 会 提供 对 HIMLS 元 素 的 民 好 文 持 。 这 意味 着 ， 全 少 对 属于 “ 智 
能 手机 ”或 “平板 电脑 ”的 设备 来 说 ， 可 以 默认 使 用 HIMLS 元 素 而 不 用 担心 蔡 代 方法 和 藤 
入 层 。 因 此 ， 让 我 们 总 结 一 下 HIMILS 的 重要 因 系 吧 。 
12.1.1 HTML5 对 忙碌 的 开发 人 员 意 味 着 什么 

HTMLS 标志 着 Web 第 三 个 时 代 的 来 临 ， 它 使 HTML 稳步 发 展 成 真正 的 、 完 全 成 熟 的 应 
用 程序 交付 格式 。HTMLS5 并 不 局 限于 呈现 ; 更 准确 地 说 ， 它 还 为 Web 以 及 其 他 类 型 的 应 用 
程序 提供 了 一 系列 的 新 功能 。 最 大 的 变化 是 ，HTML5 是 关于 客户 端 编程 和 构建 可 以 在 浏览 
器 内 部 运行 并 与 后 端 进行 有 限 交互 (或 不 交互 ) 的 应 用 程序 。 

相 比 其 前 身 (在 十 多 年 前 定义 的 )，HTMLS 是 一 个 明显 更 丰富 的 标记 语言 。 可 以 说 这 些 年 
的 开发 经 验 并 没有 白费 ， 因 为 现在 HTML5 在 标准 语法 中 集成 了 开发 人 员 和 设计 师 在 数 干 个 
网 站 中 所 采用 的 很 多 常见 做 法 。 在 此 过 程 中 ，HTMLS 提出 了 如 何 构造 HTML 元 素 的 具体 规 
则 ， 并 反对 使 用 过 去 引入 的 文 持 样式 元 系 的 标签 。 新 的 建议 是 ， 应 该 将 CSS 用 于 样式 元 京 ， 
并 使 用 特定 的 (新 ) 标 签 来 定义 文档 的 结构 。 


1. 语义 标记 
大 多 数 网 站 都 共同 使 用 一 种 第 见 布 局 ， 包 括 页 眉 、 页 脚 和 页 面 左 侧 的 寻 航 栏 。 这 些 效果 


往往 是 通过 使 用 回 左 或 同 右 对 齐 样 式 的 <div> 元 系 样 式 来 实现 的 。 大 多 数 页 面 最 终 使 用 的 都 是 


如 下 的 模板 ， 我 们 在 这 本 书 的 所 有 示例 中 使 用 的 也 是 这 个 模板 : 


<div 1q="Padgqe"> 
<d1V ld="header™"> 


</d1LV> 
<diy 1d="navbarnm> 
<Ul> 
I sa < i> 
<11> ... </11> 
LT su» 过 /11> 
</ul> 
</div> 
<diyv id="container™> 
<diy 1id="]left-sidebar™"> 
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<ul> 
TY swe Hl1S 
<11> ... </11> 
<11> ... </11> 
</ul> 
</dliv> 
<dly ld="content"> 


</d1iv> 
<div 1d="right-sidebar™"> 


</dliv> 
</d1liv> 
<dliv ld="footer™> 


了 
</ad1IV> 
这 一 模板 包含 页 眉 、 导 航 栏 、 页 脚 以 及 它们 之 间 的 三 列 布局 。 然 而 ， 单 独 使 用 上 面 的 标 


记 并 不 会 产生 预期 的 效 末 。 为 此 ， 你 需要 在 单个 <div> 元 素 中 添加 特 设 的 CSS 样式 ， 使 这 些 
元 系 处 于 巧 序 状 态 并 你 振 回 定 于 左边 缘 或 右边 绿 。 


2. HTML5 的 特别 之 处 


首先 ， 使 用 HTMLS 并 不 意味 着 你 不 能 使 用 CSS 将 布局 转换 成 更 美观 的 页 面 。 你 仍 需要 
使 用 差不多 相同 的 CSS 使 页 面 看 起 来 更 吸引 人 , 并 将 对 应 部 分 放置 在 它们 所 属 的 地 方 。 不 过 ， 
你 现在 可 以 用 更 整洁 的 方式 描述 页 面 ， 同 时 对 使 用 CSS 样式 表 的 设计 师 来 说 也 更 容易 阅读 。 
从 根本 上 说 ,在 HIMLS 中 可 以 将 普通 的 <div> 元 系 符 换 为 语义 上 更 有 意义 的 元 素 , 如 <header>、 
<footer> 和 <article>。 和 下面 显示 了 如 何 通过 使 用 最 新 的 HTML 标记 来 重 写 前 面 的 模板 。 


<header> ... </header> 
<DnaV> ... </nav> 
<article> 

<aslde> 


</aslde> 

<section> ... </section> 
<section> ... </section> 
<section> ... </section> 
<aslde> 


</aslide> 
</article> 
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<footer> ... </footer> 

<nav> 元 素 会 对 将 在 导航 栏 中 出 现 的 链接 进行 逻辑 分 组 。<article> 元 素 代 表 了 页 
容 的 容器 ， 并 集成 了 <aside> 元 素 和 <section> 元 素 。 

这 些 元 素 都 是 块 元 素 ， 它 们 必须 被 适当 设计 以 形成 符合 要 求 的 页 面 。 其 他 新 元 素 补 全 了 
增 效 元 了 系 的 列表 ， 如 <figure> 和 <details>。<figure> 元 系 被 设计 为 包含 带 有 说 明 的 图 片 ， 而 
<details> 蔡 代 了 开发 人 员 用 来 隐藏 可 选 内 容 和 通过 JavaScript 显示 该 内 容 的 标准 隐藏 <div>。 


3. 本 地 可 折 垒 元素 


新 的 <details> 元 素 在 功能 上 等 同 于 <div>, 但 其 内 在 内 容 由 浏览 器 来 解释 ， 并 用 于 实现 
个 可 折 著 面板 。 下 面 是 该 新 元 素 的 一 个 示例 : 


<detalils open="true"> 


面 任意 内 


<summary>Drill down</summary> 
<div 1id-"detalls naside"> 
This text was linitially kept hidden from view 
</div> 
</details> 


open 特性 会 指示 你 是 否 要 对 内 容 进 行 初始 显示 (参见 图 12-1)。<summary> 元 素 会 为 可 单 
击 的 占 位 符 指 定 文本 ， 剩 下 的 内 容 会 被 隐藏 起 来 或 按 需 显示 。 在 撰写 本 书 时 ， 人 谷歌 Chrome 
和 苹果 Safari 浏 览 器 就 成 为 了 少数 几 个 支持 此 功能 的 浏览 右 。 但 Internet Explorer 11 并 不 支持 。 


[| localhost:3595 Se 
二 祝 己 绅 |[D localhost3595 
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DETAILS 


Drill down 


This text was initially kept hidden from view 


图 12-1 在 谷歌 Chrome 中 运行 的 新 的 <details> 元 素 


注意 : 
如 果 想 支持 能 够 兼容 HTMLS5 的 浏览 器 ， 同 时 保持 与 旧 浏 览 器 的 兼容 ， 那 么 你 需要 同时 
使 用 新 的 HIMLS 标签 和 替换 标签 ; 旧 的 浏览 器 会 直接 忽略 掉 新 的 HTMLS5 标签 。 
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你 在 图 中 看 到 的 图 标 是 由 浏览 器 提供 的 。<details> 元 素 需 要 一 点 CSS 来 增加 美观 性 。 下 
面 是 用 于 图 12-1 中 所 示 元 又 的 CSS: 


<style> 

summary 1 
padding: Spx; 
font—-weight: bold; 
COlor: #708090; 

} 


#detalils inside { 
font—style: italic; 

} 

</style> 


注意 : 

HTML5 移 除 了 一 些 只 会 增加 宛 余 的 没有 多 大 用 处 的 元 素 。 这 些 不 再 受 支持 的 元 素 中 最 
引 人 注 目的 是 <frame>( 不 过 IFRAME 元 素 仍 存在 ) 和 <font> 元 订 。 此 外 ， 还 移 除了 几 个 样式 元 
率 ， 比 如 <center>、<U> 和 <big>。 其 原因 是 这 些 功 能 可 以 通过 CSS 轻松 地 实现 。 出 于 某 些 原 
因 ， 现 行 草 案 保留 了 类 似 <b> 和 <i> 这 样 的 元 素 。 


4. 新 的 输入 类 型 


目前 ，HTML( 其 次 是 浏览 器 ) 只 支持 纯 文 本 作为 输入 。 日 期 、 数 字 ， 甚 至 电子 邮件 地 址 之 
间 均 有 不 少 差异 ， 更 不 用 说 预定 义 的 值 了 。 如 今 开发 人 员 要 负责 通过 实现 输入 文本 的 客户 端 
验证 来 避免 用 户 输入 不 必要 的 字符 。jQuery 库 有 几 个 简化 该 任务 的 插件 ， 但 这 正好 强化 了 一 
个 观点 一 输入 是 一 个 棘手 的 问题 。 

HTMLS5 带 有 大 量 的 用 于 <input> 元 素 特性 类 型 的 新 值 。 另 外 <input> 还 依赖 几 个 主要 与 这 
些 新 输入 类 型 相关 的 新 特性 。 下 面 是 几 个 例子 : 


<input type="date™ /> 
<input type="time™" /> 
<input type="range™ /> 
<input type="number™ /> 
<input type="search™ /> 
<input type="color™ /> 
<input type="email™ /> 
<input type="url"™" /> 
<input type="tel™ /> 


这 些 新 输入 类 型 的 实际 效果 是 什么 呢 ? 虽 然 没 有 完全 标准 化 ， 但 预期 的 效果 是 浏览 器 所 
供 特 设 的 UI， 用 户 可 以 轻松 地 输入 日 期 、 时 间或 数字 。 其 中 的 一 些 新 输入 类 型 专门 针对 手机 
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网 站 用 户 的 需求 。 尤 其 是 , email、 url 和 tel 类 型 会 推动 智能 手机 上 的 移动 浏览 器 (比如 iPhone、 
Android、Windows Phone) 上 自动 调整 键盘 的 输入 值 范 围 。 图 12-2 显示 了 在 iPhone 上 的 tel 输入 
字段 键入 字符 的 效果 键盘 默认 为 数字 和 与 手机 有 关 的 符号 。 


3ITA 3G 11:22AM 46% E 


图 12-2 iPhone Safari 上 的 tel 输入 字段 。 你 会 在 Android 和 Windows Phone 上 发 现 类 似 的 实现 


当前 ， 不 是 所 有 浏览 器 都 提供 相同 的 体验 ， 而 且 虽 然 它 们 基本 上 对 与 各 种 输入 类 型 相关 
联 的 UT 处 理 是 一 致 的 ， 但 仍 存在 着 一 些 主要 差别 ， 这 可 能 需要 开发 人 员 添 加 基于 脚本 的 自 
定义 填充 。 举 个 例子 ， 我 们 考虑 一 下 日 期 类 型 。 在 撰写 本 书 时 ， 由 Opera 提供 的 界面 与 你 在 
Chrome 中 看 到 的 就 不 一 样 ( 见 图 12-3); Internet Explorer11 则 没有 提供 任何 对 日 期 的 特殊 支持 。 

一 般 来 说 ， 最 新 智能 手机 上 的 移动 浏览 器 都 是 兼容 HTMLS 元 素 的 。 尽 管 如 此 ， 作 为 移 
动 网 站 的 开发 人 员 ， 在 使 用 新 的 像 email、number、url、date、tel 这 样 的 输入 元 素 时 ， 可 能 
仍然 需要 谨慎 ， 最 好 对 所 有 内 容 小 心 处 理 ! 

最 后 ， 值 得 注意 的 是 ， 实 现 了 大 家 期 盼 已 久 功能 的 占 位 符 特 性 ， 会 在 可 能 的 文本 框 中 显 
示 提 示 ， 而 范围 和 日 期 /时 间 和 输入 字段 则 不 会 显示 提示 文本 。 


注意 : 

归根 结 底 ， 除 非 浏览 器 主动 统一 地 支持 新 的 输入 字段 ， 否 则 开发 人 员 仍 需要 做 一 些 有 关 
JavaScript 填充 的 工作 ,确保 正确 的 数据 提交 到 服务 器 ,从 而 使 用 户 正 确 了 解 哪 里 出 了 错 。 移 
动 端 页 面 比 末 面 页 面 更 多 地 受益 于 HTML5 兼容 的 浏览 器 。 
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图 12-3 ”当前 由 谷歌 Chrome 实现 的 date 输入 字段 
5. <datalist> 元 素 


HTMLS 表单 中 的 男 一 个 非常 好 的 改进 之 处 是 <datalist> 元 素 。 该 元 素 是 流行 的 <select> 元 
素 的 特殊 版 本 。 它 提供 了 与 <select> 元 素 相 同 的 行为 ， 但 下 拉 列 表 是 应 用 于 文本 输入 字段 的 。 
下 面 是 一 个 示例 : 
<input list="countries™" /> 
<datalist 1id="countries"> 
<option value="Italy"> 
<option value="Austria"> 
<option value="Australia"> 
<option value="Albania"> 
<option value="Sweden"> 
<option value="Denmark"> 
</datalist> 
实际 影响 是 ， 当 和 输入 字段 接收 到 焦点 时 ， 荣 单 即 会 显示 出 来 ， 用 户 可 以 输入 任意 文本 ， 
也 可 以 选取 一 个 预定 义 的 选项 。 图 12-4 显示 了 谷歌 Chrome 浏览 器 提供 的 该 功能 。 


6. 本 地 存储 


HTMLS 提供 了 一 个 标准 的 API， 使 用 户 在 设备 上 存储 数据 更 可 控 ， 代 表 了 对 cookie 的 
有 效 替 代 。 本 地 存储 的 平均 大 小 为 S MB 左右 ， 比 cookie 更 大 。 
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DATALIST 


Albania 


12-4 ”运行 中 的 <datalist= 元 素 


你 要 通过 由 浏览 器 窗口 对 象 公开 的 localStorage 属性 来 访问 本 地 存储 。localStorage 属性 
提供 了 一 个 基于 字典 的 编程 接口 ， 类 似 于 cookie 的 编程 接口 。 可 使 用 方法 来 添加 和 移 除 项 、 
计算 存储 中 的 项 数 、 获 取 特定 项 的 值 ， 以 及 清空 存储 。 下 面 显示 了 如 何 保存 一 个 值 以 及 稍 后 

<script type="text/Javascript"> 

function save() 1{ 

window.localstorage["message"] = "hello"; 
} 
function 1init() 1 
document .getElementById ("message") .innerHTML = 
window.localstorage["message"]; 


} 
</script> 


加 载 后 ， 页 面 会 检索 并 显示 来 日本 地 存储 (如 果 有 的 话 ) 的 数据 。 这 些 数 据 通 过 一 个 以 交 
互 方式 调用 的 函数 被 保存 到 存储 器 。 保 存 到 本 地 存储 器 的 数据 会 无 限期 保留 在 用 户 的 设备 上 ， 
除非 你 以 编程 方式 清空 它 。 该 存储 是 特定 于 应 用 程序 的 。 

除了 localStorage，HTMLS5 还 提供 了 一 个 sessionStorage 对 象 ， 它 具有 相同 的 编程 接口 ， 
但 会 保存 到 浏览 器 的 内 存 。sessionStorage 对 象 会 在 当前 浏览 器 会 话 结束 时 被 清空 。Web 存储 
接受 基本 类 型 (但 规范 在 这 一 点 上 并 没有 限制 ， 因 此 可 以 接受 任何 JavaScript 类 型 ), 但 如 果 序 
列 化 为 JavaScript 对 象 标记 (JSON) 格 式 ， 也 可 以 保存 复杂 的 对 象 。 


7. 音频 和 视频 


HTMLS 的 3 


“大 好 处 之 一 是 告别 了 (但 真 的 能 说 再 见 吗 ? ) 仅 为 播放 音频 和 视频 的 外 部 插 
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件 ， 如 Flash 和 Silverlight。HTMLS 和 带 来 了 两 个 新 元 素 <audio> 和 <video>， 它 们 指向 URL 并 
播放 任何 内 容 。 这 些 标签 的 浏览 器 实现 也 预期 会 为 用 户 提 供 一 个 可 以 暂停 和 恢复 播放 的 控制 
栏 。 下 面 显示 了 如 何 链接 一 个 音频 资源 。 
<audio poster="init.png" controls="controls"> 
<source src="nicestory.wav" /> 
</audlio> 
多 媒体 元 素 ( 主 要 是 指 视频 ) 的 硬 伤 是 文件 的 格式 ， 既 包括 文件 格式 ， 也 包括 编码 解码 器 。 
HTMLS 标准 不 会 对 编码 解码 器 进行 正式 调用 ， 所 以 对 有 关 格 式 的 文 持 将 依然 取决 于 供应 商 。 
从 开发 人 员 的 角度 来 看 ， 这 并 不 是 好 销 轧 ， 因 为 它 代 表 了 一 个 分 上 政 点 ; 不 同 的 浏览 器 文 持 不 
同 的 格式 ， 而 你 需要 检测 浏览 器 或 为 浏览 器 提供 多 个 可 供 选 择 的 文件 。 下 面 是 指示 选择 视频 
格式 的 语法 : 
<video poster="init.png" controls="controls"> 
<SOUTCe src="tiger.mp4" type="video/mp4" /> 
<SOUTCe src="tiger.webm" type="video/ogg™" /> 
Oops, it seems that your browser doesn't support video. 
</video> 
注意 ， 你 要 使 用 controls 特性 来 显示 控制 栏 ， 并 使 用 poster 特性 来 指定 用 作 启 动画 面 的 
图 片 ， 二 到 妹 体 准备 好 播放 。 
流行 的 编码 解 查 器 是 MP4、MOV 和 AVI。 你 应 该 为 Internet Explorer 和 Safari 准备 MP4 
编码 的 视频 ， 而 为 其 他 的 浏览 器 准备 OGG/Theora。 目 前 看 来 ， 这 似乎 是 避免 外 部 插件 的 完 
美 解决 方案 。 但 是 ， 因 为 这 是 一 个 变化 频 或 的 问题 ， 所 以 最 好 还 是 三 思 而 行 。 


12.1.2 RWD 


大 多 数 开 友人 员 和 技术 管理 人 员 还 清楚 地 记得 仅仅 十 年 前 构建 用 于 各 种 浏览 器 的 网 站 
的 于 梦 。 比 如 有 一 段 时 期 ，Internet Explorer 有 一 个 功能 集 ， 它 与 Firefox 或 者 Safari， 甚 至 是 
它 自己 的 早期 版 本 都 不 相同 。 那 真 的 把 页 面 标 记 的 编辑 工作 和 弄 得 乱七八糟 ,据说 目前 大 约 70% 
由 jQuery 组 成 的 代码 是 用 来 收拾 旧 浏 览 器 的 残局 的 , 最 显著 的 就 是 Safari 和 Internet Explorer 
的 怪异 模式 。 甚 至 可 以 说 ， 开 发 人 员 已 经 开始 遗 瑟 “浏览 嚣 大战” 了， 因为 jQuery 攻 下 了 这 
块 地 组; 男 一 方 徊 ， 浏 贤 右 大 战 无 疑 古 促成 jQuery 快速 普及 的 因 率 之 一 。 

在 移 动 领域 ,不 同人 设备 需求 的 数量 级 是 以 干 为 早 位 的 ， 不 似 不 久 前 的 果 面 浏 宽 器 的 数量 
那么 少 。 如 果 十 年 前 浏览 堪 的 混乱 程度 让 你 感到 惊 惧 ， 那 么 面 对 今 天 数量 庞大 得 多 的 各 种 移 
动 设 备 又 该 怎么 办 呢 ? 这 是 真正 的 痛 将 之 源 。 铭 记 于 此 ， 开 发 人 员 学 会 了 要 把 重点 放 在 有 效 


的 功能 上 ， 而 不 是 专注 在 与 浏览 器 类 型 和 名 称 相 关 的 通用 性 能 上 上。 然而， 这 一 原则 理解 起 来 
简单 ， 用 于 实践 却 很 难 。 这 正 是 RWD 的 出 发 点 。 
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1. 特征 检测 


通过 后 面 示例 中 的 横向 思维 ，RWD 才 应 运 而 生 。 设 备 检测 很 难 ? 好 吧 ， 就 不 要 那么 做 。 
你 抓 住 客户 端 上 可 用 基本 信息 的 几 个 片段 (比如 浏览 器 窗口 大 小 )， 设 置 特 设 的 样式 表 ， 让 浏 
览 右 在 页 面 中 相应 地 重 排 内 容 。 

你 要 停止 检测 请 求 设备 的 功能 ， 并 根据 可 以 在 设备 上 以 编程 方式 检测 的 内 容 来 决定 显示 
的 内 容 。 这 种 方式 广泛 依赖 大 量 的 浏览 器 技术 一 一 主要 是 CSS 媒体 查询 一 一 有 旦 市 来 了 明显 的 
好 处 ， 作 为 开发 人 员 ， 你 只 需要 设计 和 维护 一 个 网 站 即 可 。 灵 活 适 应 内 容 的 担子 就 沙 到 了 图 
形 设 计 师 或 像 Twitter Bootstrap 这 样 的 特 设 库 身 上 。 

功能 检测 的 主要 优势 ， 我 们 可 以 总 结 为 “一 个 站 点 适合 所 有 情况 ”， 却 也 可 能 成 为 最 主 
要 的 弱点 。 你 真 的 只 想 要 一 个 网 站 吗 ? 你 真 的 想 对 智能 手机 、 平 板 电脑 、 笔 记 本 电脑 和 智能 
电视 提供 “相同 ”的 网 站 吗 ? 这 个 问题 的 答案 总 是 要 针对 于 具体 的 业务 。 总 体 而 言 ， 只 能 说 
“ 视 情 况 而 定 ”。 

让 我 们 首先 了 解 RWD 的 本 质 ， 然 后 探讨 它 可 能 的 缺陷 。 


2. CSS 媒体 查询 


让 RWD 焕发 生命 力 的 是 CSS 媒体 查询 。 媒 体 查询 在 CSS 3 中 引入 ， 是 开发 人 员 定义 带 
条 件 的 CSS 样式 表 的 语法 , 在 窗口 调整 大 小 或 发 生 其 他 一 些 系统 事件 时 浏览 器 就 会 动态 加 载 
该 CSS 样式 表 。CSS 媒体 查询 使 开发 人 员 能 够 轻松 地 创建 多 视图 页 面 ， 它 可 以 通过 不 同 尺 二 
屏幕 的 设备 来 使 用 ， 从 24 英寸 的 桌面 显示 器 到 大 部 分 3 英寸 屏幕 的 智能 手机 都 行 。 


注意 : 
需要 指出 的 重要 一 点 是 ，CSS 媒体 查询 不 是 专门 针对 移动 开发 的 一 种 技术 。 然 而 ， 其 内 
在 能 力 和 解决 方 策 的 灵活 性 使 得 它 也 很 适合 用 在 手机 网 站 的 建设 上 。 


对 开发 人 员 来 说 ，CSS 媒体 查询 的 主要 优势 是 明显 的 。 开 发 人 员 只 需要 编写 一 组 页 面 和 
一 个 后 端 。 这 组 页 面 针 对 的 是 你 打算 支持 的 最 宽 可 能 屏幕 一 一 通常 是 果 面 大 小 一 一 并 存储 尺 
可 能 多 的 元 素 。 接 着 ， 设 计 师 要 提供 多 个 CSS 文件 ， 每 一 个 支持 一 个 中 等 大 小 屏幕 的 尺寸 。 
中 等 大 小 屏幕 的 尺寸 称 为 布局 断 点 。 最 常见 的 情况 是 ， 你 有 一 个 断 点 是 480 像素 ， 另 一 个 是 
800 像素 ， 可 能 还 有 更 多 个 断 点 。 当 用 户 将 浏览 器 窗口 的 宽度 调 成 低 于 480 像素 时 ， 浏 览 器 
束 会 日 动 选择 用 于 480 像素 的 CSS。 当 窗口 宽度 调 为 介 于 480 像素 和 800 像素 之 则 时 浏览 玖 
也 会 自动 选择 ;在 这 种 情况 下 会 选择 用 于 800 像素 的 CSS。 当 相同 的 页 面 是 在 智能 手机 中 浏 
览 时 ,会 目 动 应 用 用 于 小 屏幕 的 CSS(480 像素 ); 而 平板 电脑 可 能 会 得 到 800 像素 的 布局 。 这 
种 方式 简单 而 有 效 。 

通过 添加 男 一 个 断 点 和 相关 的 CSS 文件 , 可 以 创建 一 个 屏幕 大 小 介 于 480 像素 和 800 像 
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素 之 间 的 特 设 视图 。 这 样 ， 你 还 可 以 解决 迷你 平板 的 问题 。 你 需要 支持 像 智 能 电视 这 样 的 大 
屏幕 吗 ? 没 问题 。 只 需要 添加 另 一 个 CSS 文件 即 可 。 真 的 很 容易 ， 它 非常 好 用 ， 虽 然 设 置 一 
个 能 用 于 现实 中 复杂 页 面 的 RWD 解决 方案 没 那么 简单 。 


3. 运行 中 的 CSS 媒体 查询 


你 想 文 持 多 少 种 不 同 的 屏幕 分 辨 率 ? 答案 取决 于 预期 的 受众 和 要 呈现 的 内 容 。 不 过 ， 宽 
度 调整 为 400 像素 的 更 面 浏览 器 和 屏幕 大 小 相同 的 智能 手机 之 间 却 有 着 巨大 的 差异 。 就 计算 
能 力 和 资源 方面 而 言 ， 笔 记 本 电脑 是 一 回 事 ; 智能 手机 完全 是 另 一 回 事 。 不 过 ，CSS 媒体 查 
询 无 法 基于 单 台 设备 进行 区 分 。 

我 们 假设 现在 这 不 构成 问题 ， 青 进一步 假设 从 业务 的 角度 出 发 ， 专 注 于 视窗 的 大 小 是 可 


以 接受 的 。 首 先 ， 你 需要 决定 打算 为 多 少 个 分 辨 率 使 用 不 同 的 布局 。 一 个 分 类 示例 可 能 由 以 
下 断 点 构成 : 


e 最 大 480 像素 
se 最 大 800 像素 
e 大 于 800 像素 


对 于 每 一 个 断 点 ， 你 要 创建 一 个 不 同 的 CSS 文件 来 安排 样式 元 素 ， 包 括 将 它们 顺 次 放 到 
屏幕 底部 或 隐藏 其 中 一 些 。 这 样 一 来 ， 如 有 果 页 面 链接 的 是 静态 图 片 的 话 ， 你 还 可 以 决定 引用 
较 小 的 图 片 。 


通过 使 用 用 于 <link> 元 素 的 经 典 语法 的 轻微 变 体 ， 你 就 能 引用 这 些 CSS 文件 : 


<1link type="text/css" 
rel="stylesheet™ 
href="vljew480 .css" 
media="only Screen and (max-width: 480px) "> 
在 这 个 例子 中 ,view480.css 文件 只 有 当 页 面 呈现 在 屏幕 上 是 浏览 器 窗口 不 大 于 480 像素 
时 才 会 用 到 。 当 使 用 媒体 全 询 且 未 找到 匹配 项 时 ， 显 然 没 有 样式 表 会 被 应 用 到 页 面 。 


注意 : 

过 去 ，media 特性 表明 CSS 为 何 种 媒体 而 设计 一 一 屏幕 、 打 印 机 、 电 视 、 视 频 终 端 等 。 
在 支持 全 部 CSS 3 标准 的 现代 浏览 器 中 ，media 特性 的 值 可 以 包括 一 个 选择 媒体 和 一 些 运行 
时 条 件 的 查询 。 在 http:Wwww.w3.org/TR/css3-mediaqueries 处 可 以 找到 关于 媒体 查询 的 全 部 
文档 。 


CSS 媒体 查询 语言 是 基于 一 对 布尔 运算 符 一 一 and 和 not 一 一 以 及 一 些 浏览 器 属性 的 。 表 
12-1 列 出 了 你 能 用 来 选择 最 适合 样式 表 的 浏览 器 属 性 。 
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表 12-1 构建 CSS 媒体 查询 的 属性 


浏览 羡 属 性 朱 述 
设备 宽度 、 设 备 高 度 物理 设备 屏幕 的 宽度 和 高 度 
宽度 、 高 度 呈现 视 禄 的 宽度 和 噩 度 ; 例如 ， 浏 览 侯 窗口 
方 加 当 高 度 大 于 或 等 于 宽度 时 返回 纵向 。 否 则 返回 横 回 
高 宽 比 表明 宽度 与 高 度 之 间 的 比例 ; 例如 “16/9” 
设备 高 宽 比 表明 设备 宽度 与 设备 高 度 之 间 的 比例 ， 例 如 “16/9” 


请 记 住 ， 设 备 宽度 和 设备 高 度 、 以 及 宽度 和 高 度 属性 也 支持 min/max 前 级 。 

通常 在 媒体 查询 表达 式 的 开头 你 会 发 现 关键 字 only， 但 它 实际 不 具有 功能 性 作用 。 添 加 
这 个 关键 字 的 唯一 目的 是 从 媒体 查询 语句 中 排除 旧 的 浏览 器 ， 当 媒体 类 型 带 有 only 前 级 时 
旧 的 浏览 器 就 不 能 理解 该 媒体 类 型 ， 并 且 将 直接 忽略 该 语句 。 

如 前 面 所 示 ， 可 以 在 宿主 页 面 的 <link> 元 素 内 部 使 用 媒体 查询 表达 式 。 这 样 一 来 ， 你 最 
终 会 让 每 个 断 点 使 用 一 个 单独 的 CSS。 你 还 可 以 创建 包含 多 个 媒体 节 的 单个 CSS 文件 ， 如 以 
下 代码 所 示 : 


amedla screen and (min-width: 480PpPXx) { 


body { 
background: yellow; 
} 
} 
media screen and (min-width: 800px) { 
body { 
background: blue; 
} 
} 
注意 : 


无 论 是 创建 单个 文件 还 是 多 个 文件 ， 都 应 考虑 到 在 RWD 解决 方案 中 ， 你 要 处 理 大 量 的 
CSS 设置 ， 大 部 分 都 是 重复 性 的 。 为 此 ， 查 看 一 下 像 LESS(http://lesscss.org) 这 样 的 动态 样式 
表 框 架 是 值得 的 。 使 用 这 些 类 型 的 框架 ， 你 就 能 使 用 像 变 量 和 函数 这 样 的 友好 编程 结构 来 动 
态 创建 CSS 设置 。 


在 表 12-1 中 ， 有 两 个 看 起 来 类 似 的 属性 : 宽度 和 设备 宽度 。 如 前 所 述 ， 前 者 指 的 是 浏览 
露 的 宽度 ， 后 者 表示 的 是 设备 的 屏幕 宽度 。 为 了 目 适 应 呈现 ， 你 应 该 一 直 使 用 宽度 。 不 过 ， 
在 移动 设备 (智能 手机 和 平板 电脑 ) 上 ， 任 何 应 用 程序 都 可 以 在 全 屏 模式 下 使 用 ， 上 所 以 这 两 者 
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其 实 并 没有 实际 区 别 。 在 这 一 点 上 ，Windows 8 平板 电脑 是 一 个 值得 注意 的 例外 设备 ， 因 为 
除了 全 屏 模 式 ， 应 用 程序 还 可 以 在 分 屏 和 填充 模式 中 运行 。 


注意 : 

在 CSS 媒体 查询 等 级 4(http://dev.w3.org/csswg/mediaqueries4， 这 是 下 一 个 标准 版 本 ) 中 ， 
会 添加 一 些 有 助 于 区 分 移动 设备 和 果 面 设备 的 新 属性 。 不 过 ， 这 似乎 并 不 是 设备 性 能 集 ， 开 
发 人 员 不 需要 真 的 为 其 制定 面向 移动 端 视图 。 


4. 流动 布局 


单独 使 用 CSS 媒体 得 询 并 不 能 真 的 实现 啊 应 式 布局 , 但 它 确实 在 菜 种 程度 上 有 助 于 啊 应 
动态 修改 的 条 件 。 如 果 设 计 只 是 为 了 迎合 一 些 预 设 断 点 的 话 ， 那 么 用 户 将 得 到 相同 的 布局 ， 
无 论 其 浏览 器 的 宽度 是 否 介 于 两 个 断 点 之 间 。 例 如 ， 假 设 你 使 用 了 以 下 设计 : 


media screen and (min-width: 480px) 1 
body { 
background: yellow; 
} 
#container f 
width: 480px; 


} 
} 
media screen and (min-width: 800px) 1 
body { 
background: blue; 
} 
#container { 
width: 800px; 
} 
} 


当 浏 览 器 宽度 达到 480 像素 时 你 有 一 个 断 点 一 一 些 时 ， 背 景 将 变 成 黄色 旦 容器 元 素 将 设 
置 成 480 像素 。 可 以 扩大 浏览 器 窗口 ， 但 只 有 在 其 宽度 达到 800 像素 时 你 才能 注意 到 变化 。 
图 12-5 描绘 了 600 像 系 时 的 一 个 屏幕 截图 。 

由 于 该 布局 使 用 了 固定 度量 值 ， 因 此 我 们 最 终 会 发 现 一 些 空 的 未 使 用 的 空间 。 可 通过 添 
加 更 多 的 断 点 并 编辑 和 保持 更 多 CSS 文件 来 消除 未 使 用 空间 的 影响 。 然 而 , 对 于 非 测 试 站 点 ， 
你 实际 上 不 能 处 理 3 个 或 4 个 以 上 的 断 点 。 
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(9) http://localhost30578/ 


Sm “十 


MQ In action 


Smartphone 


图 12-5 一 个 自 适应 但 并 非 完全 响应 式 的 视图 


一 个 真正 的 响应 式 布局 是 一 个 可 以 适应 浏览 器 窗口 的 宽度 和 /或 高 度 任意 变化 的 布局 。 要 
达成 此 效果 ， 你 需要 使 用 基于 字符 长 度 或 比例 的 CSS 度量 值 来 构建 你 的 布局 。 以 这 种 方式 ， 
你 的 设计 可 以 几乎 不 受 限 地 放大 和 缩小 。 这 有 时 也 称 为 流动 布局 或 按 比 例 布局 。 

在 CSS 中 ， 可 以 使 用 一 些 单位 来 设置 宽度 、 高 度 和 字体 大 小 。 有 一 个 单位 正 变 得 越 来 越 
流行 ， 这 就 是 字符 长 度 。 一 个 字符 长 度 就 等 于 当前 的 字体 大 小 ; 接着 ,“1.2 字符 长 度 ” 会 将 
当前 字体 大 小 增加 20%。 像 素 和 点 都 是 固定 单位 ， 量 不 能 随 窗口 大 小 而 缩放 。 然 而 ， 比 例 和 
字符 长 度 都 是 相对 上 度量 值 一 一 尽管 其 相对 的 内 容 不 同 。 字 符 长 度 单位 总 是 相对 于 字体 大 小 的 ， 
而 比例 是 相对 于 包含 块 的 (例如 ，<body> 或 <div>)。 也 可 以 将 比例 应 用 到 字体 大 小 。 在 这 种 情 
况 下 ， 它 表示 的 是 与 父 字 体 大 小 相关 的 变化 。 通 常 ， 我 认为 使 用 比例 来 表示 Web 元 素 的 尺寸 
( 块 和 文本 ) 更 加 可 靠 ， 并 且 可 以 得 到 路 浏览 器 的 一 致 性 。 

话 虽 如 此 ， 但 流动 布局 主要 是 为 了 通过 相对 度量 来 表示 位 于 布局 中 的 内 容 。 


5. 当 RWD 遭遇 移动 端 


RWD 绝对 是 一 种 Web 设计 的 强 有 力 的 方法 。 它 会 以 两 种 方式 回 你 提供 帮助 :， 首先 ， 它 
使 你 的 站 点 看 起 来 更 棒 ， 而 不 用 在 乎 浏览 器 的 大 小 ; 其次， 通过 同 Twitter Bootstrap 这 样 的 
框架 ， 它 还 能 让 非 设计 者 得 以 快速 创建 很 好 的 模板 。 不 过 ，RWD 却 并 非 为 专门 服务 移动 设 
备 而 设计 的 , 但 它 的 功能 强大 而 灵活 , 所 以 也 能 用 于 几乎 所 有 移动 设备 上 的 自 适应 页 面 视图 。 

移动 设备 的 一 个 关键 特征 是 其 屏幕 更 小 一 智能 手机 大 约 400 像素 ， 而 平板 电脑 大 约 
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800~1000 像素 。 当 RWD 将 你 的 视图 很 好 地 呈现 在 那些 尺寸 的 屏幕 上 时 ， 你 的 设置 工作 就 算 
完成 了 一 一 对 吗 ? 

RWD 需要 CSS 和 CSS 媒体 查询 才能 工作 。 使 用 CSS， 可 以 完成 很 多 任务 , 但 CSS 与 编 
程 并 无 关系 。CSS 媒体 查询 属性 会 告知 你 关于 设备 的 一 些 信 息 ， 但 它 不 能 提供 你 需要 知道 的 
所 有 信息 。 例 如 ， 有 关 操 作 系 统 的 信息 ， 以 及 设备 是 否 是 移动 手机 、 平 板 电 脑 、 智 能 电视 、 
或 是 网 络 机 器 人 等 ， 这 些 你 仍然 一 无 所 知 。 

例如 ，RWD 会 告知 你 当前 托管 在 视窗 上 的 页 面 宽 度 是 800 像素 。 但 是 ， 它 不 能 向 你 表 
明 该 视窗 属于 平板 电脑 还 是 属于 可 缩放 大 小 的 Internet Explorer 果 面 窗口 。 有 时 候 ， 这 是 给 最 
终 用 户 带 来 相当 大 差距 的 细节 ; 随 之 对 于 开发 人 员 也 是 如 此 。 因 此 ， 问 题 就 变 成 RWD 到 底 
在 哪些 方面 能 够 符合 移动 端 方案 ? 当 你 要 创建 一 个 移动 端 网 站 时 使 用 RWD 义 是 任 真 的 值得 
信赖 呢 ? 

移动 设备 与 典型 的 个 人 计算 机 不 同 。 它 的 屏幕 更 小 一 有 时 是 很 小 的 屏幕 。 和 它 并 不 具有 
相同 的 计算 能 力 和 存储 ; 它 并 不 具有 相同 的 电源 ; 且 它 通常 都 是 可 触摸 的 (这 对 于 桌面 端 来 说 
通常 无 法 做 到 ， 尽 管 较 新 的 型 号 可 能 会 使 用 触摸 屏 显 示 器 )。 上 由 者 ， 移 动 设备 通 常 是 在 移动 中 
使 用 的 ， 这 是 为 了 快速 迅即 地 处 理事 务 。 因 此 ， 其 连接 可 能 会 发 生 在 任何 时 候 ， 并 且 有 时 连 
接 速 度 可 能 会 较 慢 和 不 稳定 。 

当 用 户 正 在 使 用 移动 设备 时 ， 他 们 会 想 通 过 一 两 次 单 击 就 找到 选项 和 操作 ;他 们 很 可 能 
不 需要 大 量 的 功能 和 信息 。 有 时 候 他 们 需要 的 信息 或 信息 聚合 与 适合 所 有 站 点 的 那些 信息 是 
不 同 的 。 移 动 端 用 户 可 能 需要 不 同 的 运行 指引 并 且 肯 定 需 要 你 仔细 制定 应 用 程序 的 用 例 。 

RWD 是 采用 为 桌面 端 设计 的 站 点 并 让 该 站 点 在 各 种 移动 设备 上 良好 呈现 的 一 种 极 佳 方 
式 。 但 即使 这 样 ， 你 最 终 也 未 必 能 得 到 一 个 为 移动 设备 而 优化 的 站 点 。 许 多 开发 人 员 有 时 会 
宣称 以 移动 优先 的 方式 来 进行 设计 ， 但 他 们 所 做 的 实际 上 是 为 更 面 端 进行 设计 ， 然 后 仅仅 将 
该 设计 适应 到 移动 端 而 已 。 我 认为 这 肯定 不 是 移动 优先 的 设计 方式 ! 


注意 : 
RWD 能 够 很 好 地 用 于 像 门户 这 样 的 网 站 。 而 对 于 有 具有 高 度 可 交互 性 、 实 现 工 作 流 (比如 
一 个 预订 站 点 ) 且 充斥 着 用 户 必须 填充 的 表单 的 站 点 就 不 能 达到 相同 的 适用 性 了 。 


12.1.3 jQuery Mobile 的 执行 摘要 

jQuery Mobile(iQM) 是 在 流行 的 jQuery 库 上 工作 的 ， 它 是 全 新 构建 出 来 的 ， 旨 在 为 构建 
移动 站 点 提供 一 个 全 面 的 平台 。 通 过 这 个 库 你 能 够 以 你 的 方式 进行 编码 ， 而 且 这 个 库 会 负责 
在 浏览 器 上 用 最 可 行 的 方式 呈现 标记 。 通 过 使 用 jQM， 你 完全 不 必 担 心 设 备 检测 和 性 能 方面 
的 问题 。 该 库 会 确保 输出 结果 在 低级 浏览 器 上 同样 有 效 ; 无 论 得 到 的 输出 结果 是 否 真是 你 想 
要 的 .……: 而 这 就 是 另外 一 个 问题 了 。 
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ASPNET MVC 开 发 人 员 可 以 在 微软 Visual Studio 的 移动 项 目 模板 中 找到 特有 的 jQM 库 。 
这 一 事实 似乎 在 推广 一 个 愿景 , 即 jQM 是 在 网 站 中 启用 移动 端 支 持 的 一 种 必要 条 件 。 和 往常 

简单 来 说 ， ]QM 吏 是 . -个 用 于 呈现 的 JavaScript 库 ， 它 清楚 如 何 将 普通 的 HTML 标记 转 
换 成 移动 视图 。 这 意味 着 页 面 中 的 按钮 和 输入 字段 会 以 某 种 方式 进行 星 现 ， 该 呈现 方式 会 模 
拟 类 似 于 iOS 这 样 的 流行 移动 平台 的 可 视 化 元 素 的 外 观 和 感觉 (以 及 部 分 行为 )。jQM 的 简单 
易 行 给 你 的 页 面 增添 了 移动 端的 外 观 与 感 学 。 但 这 并 不 意味 着 你 的 站 点 会 突然 变 成 精心 设计 
的 移动 站 点 。 


重要 提示 : 

可 以 愉快 地 使 用 jQM( 或 者 像 Kendo UI 或 Sencha 这 样 的 其 他 供应 商 指 定 的 框架 )。 不过， 
如 果 将 站 点 设计 成 能 从 移动 设备 轻松 舒适 地 使 用 的 话 ， 就 能 从 根本 上 让 你 的 客户 感到 满意 。 
这 也 是 重新 制作 用 例 和 数据 聚合 的 问题 。 在 这 方面 没有 哪个 库 能 帮 上 你 。 


jQM 的 官方 站 点 是 http:Wwwwjquerymobilecom 。 你 还 可 以 从 NuGet 或 直接 在 
http://code.jquery.com 人 处 得 到 最 新 的 版 本 。 


1. 主题 和 样式 


如 果 没 有 一 个 关联 CSS 文件 的 话 ，jQM 库 几 乎 是 不 可 用 的 。 该 库 承 担 了 页 面 上 大 量 的 工 
作 ,， 并 将 页 面 从 普通 的 <div> 标 签 集合 转换 成 对 移动 端 友好 的 悦目 和 可 用 的 文档 。 为 了 实现 这 
一 目标 ， 必 须 遵循 严格 的 标准 创建 大 量 的 样式 和 图 片 。 该 库 有 一 个 预定 义 的 CSS 文件 要 包括 
进来 。 像 许多 其 他 内 容 一 样 ， 主 题 当然 也 是 由 开发 人 员 来 自 定 义 的 。 

jQM 库 带 有 一 些 预定 义 的 主题 ， 可 通过 字母 表 的 首 字 母 进 行 识 别 : a、b、c 等 。 每 个 主 
题 都 由 被 统一 应 用 到 各 种 HTML 元 素 的 若干 CSS 样式 构成 。 大 多 数 时 候 ， 只 需要 选取 你 想 
要 的 主题 ， 而 选择 是 基于 颜色 进行 的 。 以 下 代码 显示 了 如 何 设置 主题 。 


<div data-role="page" data-theme="b"> 
</div> 
通过 使 用 data-theme 特性 ， 你 能 够 将 不 同 主题 应 用 到 页 面 的 不 同 部 分 ( 稍 后 将 对 data-* 特 


性 进行 更 多 介绍 )。 主 题 应 用 是 默认 的 ; 不 过 ， 通 过 在 特定 元 素 上 使 用 普通 CSS 命令 ， 你 就 
可 以 重 写 其 设置 ， 如 下 所 未 : 


<div data-role="footer" class="my-footer center"> 


</d1liv> 
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上 和 面 的 <div> 元 素 被 赋予 了 页 脚 的 角色 。 就 其 本 身 而 言 ， 它 会 从 库 中 获得 一 个 特定 样式 ， 
这 取决 于 当前 的 主题 。 不 过 ，class 特性 是 用 来 重 写 一 些 属性 的 (颜色 、 边 框 、 和 字体 等 )。class 
特性 很 难 完 全 蔡 换 设置 ;如 果 你 的 目的 是 完全 葵 换 ， 可 能 最 好 的 方式 还 是 使 用 jQM 的 
ThemeRoller 工具 来 创建 你 自己 的 上 自 定 义 主题 。 


2. Data-* 特 性 


在 HTML5 中 ，data-xxx 特性 是 自 定 义 特性 ， 可 以 用 来 更 好 地 定义 元 素 的 语义 。 这 样 的 
特性 会 被 强制 使 用 data-xxx 形式 的 名 称 ， 但 是 框 染 (或 页 面 ) 要 负责 指定 该 xxx 可 变 部 分 ， 更 
重要 的 是 ， 要 负责 其 解释 。data-xxx 特性 总 是 返回 和 接受 字符 串 。 

jQM 库 能 识别 不 少 data-xxx 特性 并 使 用 它们 来 修饰 HTML 元 紊 及 赋予 其 特殊 含义 。 由 这 
些 特 性 表示 的 语义 能 确定 图 表 结 果 。 

jQM 中 最 重要 的 一 个 data-* 特 性 是 data-role 特性 。 它 表明 了 页 面 上 下 文中 特定 元 素 所 发 
挥 的 作用 。 该 特性 通 第 用 于 修饰 <div> 标 签 ， 并 将 其 作为 特定 的 语义 组 件 传 递 ， 比 如 页 眉 、 页 
脚 或 内 容 。 

3.jQM 中 的 页 面 

在 jQM 中 ， 页 面 可 以 是 单个 HTML 文件 ， 也 可 以 是 已 有 页 面 的 内 部 部 分 。 在 该 库 的 术 
语 中 ， 这 两 种 形式 被 称 为 单 页 面 模板 和 多 页 面 模板 。 非 常 棒 的 是 ,该 库 使 你 可 以 导航 到 页 面 ， 
而 不 用 在 意 其 本 质 ， 无 论 它 是 物理 页 面 (单个 HTML 文件 ) 还 是 现 有 HTML 文件 的 逻辑 部 分 。 
以 下 古典 誉 的 页 面 定 义 : 

<div 1id="homePage" data-role="page"™" data-theme="a" class="my-bkgnd"> 

i 

页 面 是 通过 被 设置 成 该 页 面值 的 data-role 特性 所 修饰 的 <div> 元 素来 定义 的 。 它 可 以 具有 
自己 的 ID 并 能 够 使 用 class 特性 来 重 写 样式 设置 。 通 过 使 用 data-theme 特性 ， 你 就 能 选择 用 
于 整个 页 面 的 主题 。jQM 页 面 通常 包含 页 眉 、 页 脚 和 内 容 。 不 过 ， 应 该 注意 的 是 ， 这 只 是 一 
种 惯例 而 已 ; 页 面 可 以 包含 任意 有 效 的 标记 。 一 个 HTML 文件 可 以 包含 多 个 被 标记 为 逻辑 页 
和 面 的 元 系 ， 比 如 下 和 面 所 示 的 这 些 : 

<div lid="homePage" data-role="page" data-theme="a"> 

</div> 

<div 1id="aboutPage" data-role="page" data-theme="b"> 


</d1iv> 
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当 使 用 多 个 逻辑 页 面 时 ， 你 应 该 会 为 每 个 逻辑 页 面 使 用 唯一 的 ID 以 局 用 导航 和 初始 化 。 
jQuery 开发 人 员 都 非常 熟悉 ready 事件 。 该 事件 在 页 面 DOM 完全 初始 化 之 后 就 会 触发 ， 
而 页 面 编写 者 能 够 安全 地 完成 页 面 元 素 的 初始 化 。 在 ]QM 中 , 你 不 会 使 用 ready 事件 ; 相反 ， 
你 要 使 用 的 是 新 的 pageinit 事件 。 
<div id="homePage" data-role="page"> 
<script type="text/Javascript"> 
$ ("#homePage™") .bind ("pageinit™", function () { alert ("home™); }); 
</Script> 


</div> 

不 同 之 处 在 于 ， 在 jQM 中 ，Ajax 调用 被 用 于 隐 式 下 载 请 求 页 面 并 设置 动画 效果 和 页 面 
转换 。 这 意味 着 页 面 (实际 页 面 或 虚拟 页 面容 器 ) 的 显示 遵循 了 与 经 典 jQuery 中 不 同 的 规则 。 

总 而 言 之 ， 你 需要 做 的 就 是 在 页 和 面 元 素 内 添加 <script> 标 签 并 绑 定 表示 有 具有 pageinit 事件 
的 页 面 的 <div>。 此 代码 确保 会 在 页 和 面 每 次 加 载 时 被 调用 , 无 论 它 是 由 一 个 链接 还 是 一 个 Ajax 
调用 请 求 的 。 在 pageinit 中 ,你 通常 要 注册 你 的 jQuery 插件 并 进行 初始 化 工作 (应 用 本 地 化 字 
符 串 、 设 置 控件 等 )。 还 有 类 似 的 事件 可 用 于 页 面 旺 示 和 和 印 载 。 


4. 页 丑 和 页 脚 


data-role 特性 常用 的 两 个 值 是 页 由 和 页 脚 。 页 眉 栏 包含 页 面 标题 和 位 于 左 侧 及 右 侧 的 一 
对 可 选 按钮 (模拟 iPhone 模板 )。 页 眉 角 色 会 接收 由 框架 指定 的 样式 并 经 受 一 些 默认 处 理 。 作 
为 开发 人 员 ， 可 以 完全 自 定义 页 眉 模 板 和 文本 以 及 按钮 的 目标 。 以 下 是 一 个 示例 页 眉 栏 : 
<dlv data-role="header"> 
<hl>Home page</hl1> 
</d1LV> 
具体 来 说 ， 第 一 个 标题 元 素 (hl 到 h6) 用 来 给 标题 栏 添加 标题 ; 如 果 其 内 容 非 空 ， 则 该 文 
本 也 将 变 成 页 面 标题 ， 也 就 是 会 重 写 为 <title> 元 素 指 定 的 任何 值 。 只 要 标题 元 素 是 Hx 元 素 ， 
则 用 哪个 标题 元 素 给 页 眉 栏 添加 标题 都 没关系 一 应 用 的 样式 也 是 如 此 。 如 果 想 单独 为 页 面 
添加 其 自己 的 标题 而 不 是 页 眉 文 本 的 话 ， 则 可 以 在 页 面容 器 上 使 用 data-title 特性 。 在 页 眉 栏 
中 出 现 的 第 一 个 链接 会 自动 变 成 按钮 样式 并 移动 到 左 侧 。 
<dliv data-role="header"™> 
<hl>ASP.NET MVC</h1> 


<a href="..." data-licon="gear">Login</a> 
</div> 


但 是 ， 第 二 个 链接 会 放置 在 右 侧 。 如 果 只 想 在 右 侧 放 置 一 个 按钮 ， 可 以 添加 一 个 额外 的 
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class 特性 ， 如 下 所 示 : 


<dliv data—role="header™> 
<h1l>ASP.NET MVC</h1l> 
< Fe -nm data con "back">Back</ay> 
<a href="...™" data-licon="gear™" class="™ui-btn-right">Login</a> 
</div> 
data-icon 特性 会 在 jQM 主题 中 选择 一 个 预定 义 的 图 标 ; ui-btn-right 值 会 将 按钮 移 到 右 侧 
(在 本 示例 中 ， 这 不 是 严格 必须 的 ， 因 为 移 到 右 侧 的 按钮 是 第 二 个 按钮 )。 需 要 说 明 的 是 ， 如 
果 使 用 ASPNET MVC 和 HTML 帮助 右 ， 则 前 面 的 锁 点 必须 像 下 面 这 样 章 写 ( 方 法 和 控制 器 
的 名 称 可 能 会 变更 ): 
QHtml .ActionLink ("Back", "index", "home", null, new {data Icon = "back"}) 
QHtml .ActionLink ("Save", "login™", “account™", null, new {data icon="gear", 
Qclass="uli-btn-right"}) 
ASPNET MVC 会 自动 将 下 划 线 ( ) 展 开 为 破 折 号 (-)， 而 @ 符 号 会 转 义 class 一 词 ， 否 则 这 
个 词 对 于 Razor 编 详 器 就 是 另 一 个 意思 了 了。 
不 同 于 页 眉 ， 页 脚 的 目的 并 非 是 为 了 简化 指定 标记 模板 。 不 过 ， 你 在 页 脚 区 域 放 置 的 任 
意 链 接 都 将 自动 变 成 按钮 ， 并 且 页 脚 中 可 以 接受 任何 标记 ， 包 括 表 单 标 记 。 这 样 ， 你 就 能 在 
页 脚 放 置 一 个 应 用 程序 栏 甚至 是 一 个 下 拉 列 表 ， 以 便 让 用 户 进行 选择 ， 比 如 选择 语言 。 注 意 
]JQM 管理 者 页 脚 栏 的 实际 位 置 。 通 过 使 用 data-position 特性 ， 你 就 能 保持 页 面 抵 部 的 位 置 不 
变 ， 如 下 所 示 : 


<div qdata-role="footer" data-position="fixed" qdata-1Ldq="about"> 

</div> 

当 用 户 单 击 链接 在 页 面 间 切 换 时 ，jQM 会 将 过 渡 形 式 应 用 到 全 部 页 面 。 有时， 你 会 得 到 
页 脚 保 持 不 变 的 平滑 效果 。 要 实现 这 一 点 ， 页 脚 必 须 在 进行 过 渡 的 两 个 页 面 中 保持 固定 ， 此 
外 ， 两 个 页 脚 必 须 具 有 设置 为 相同 (唯一 ) 标 识 符 的 data-id 特性 。 图 12-6 显示 了 带 有 页 眉 、 页 
脚 和 主体 占 位 符 的 一 个 示例 页 面 。 

要 完全 自 定义 页 眉 模 板 ， 你 需要 将 一 个 子 <div> 添 加 到 页 眉 块 并 对 其 随意 填充 。 请 记 住 ， 
如 此 一 来 你 便 失去 了 自动 处 理 功能 ; 例如 ， 链 接 会 显示 为 普通 链接 。 你 需要 data-role=button 
特性 来 进行 转换 。 
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(| 
1— Asp.NET MVC 


排 Log in ASP.NET MVC 


jQuery Mobile in action 


Content of the page 


To learmn more about this book visit) "es se 


国 100% > 


图 12-6_jQM 模板 中 的 页 由 和 页 脚 


<diy data-role="header"> 
<dliv> 
<1img src="@Url.Content ("~/content/images/mobile.png")™" alt=""> 
<h3>Custom templates</h3> 
QHtml .ActionLink ("Back™", "index", "home™"™, null, 
new {data 1icon= "back", data role="button™, @class="u1i-btn-—right"}) 
</div> 
</d1liv> 


5. 一 切 围 绕 列 表 


大 多 数 移 动 站 点 的 首页 部 应 该 仅 提 供 操作 的 列表 ， 就 像 大 约 三 十 年 前 的 应 用 程序 经 典 主 
菜单 那样 。 你 能 够 以 各 种 方式 呈现 某 单项 ;可 以 用 它们 组 成 导航 栏 、 按 钮 栏 、 磁 贴 集 合 ， 以 
及 美观 的 普通 链接 列表 。jQM 文 持 几乎 任何 方案 ， 尤 其 用 于 导航 栏 和 列表 视图 的 效果 极 佳 。 

listview 角色 提供 了 近来 移动 设备 上 最 常见 的 UI 一 一 非 第 接近 于 iPhone 和 Android 的 选 
择 列表 。 以 下 是 经 由 QM 处理 过 的 普通 HIML 代码 ， 会 产生 图 12-7 的 结果 。 


<ul data-role="11stVlIew" data-inset="true" data-theme="c" data-— 
dividertheme="a"> 
<11 data-role="11ist-divider">Chapter 12</11> 
<11>@Html .ActionLink ("Read content™, “Content™", "Home™) </11> 
<11>QHtml .ActionLink ("Run samples", "Samples", "Home"™")</11> 
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<11 data—role="]ist-divider">General</l11i> 
<11>@Html .ActionLink ("About the author™, "About™, "Home™) </11> 
<]11>QHtml .ActionLink ("About the publisher™", "About™"™, "Home™")</11> 
<11>QHtml .ActionLink ("Related books™, "About™, "Home"™) </11> 

</ul> 


Fn : ER 
< 一 lee) | http:/ /localhost:11076/ 


| ASP.NET MVC 


类 Log in ASP.NET MVC 


jQuery Mobile in action 


Chapter 12 
Read content © 


Run samples >》 


General 


About the author 


About the publisher 


Related books 


To leam more about this book visit 


图 12-7 jQM 列表 视图 


通过 使 用 <ul> 和 和 <ol> 元 紊 的 各 种 不 同 变 体 ， 你 就 能 创建 编号 列表 和 骨 套 列表 。 图 表 化 的 
变 体 包 括 data-inset 特性 和 data-filter 特性 , data-inset 负责 处 理 图 12-7 中 所 示 的 圆 角 和 美观 框 
染 ， 而 data-filter 会 添加 一 个 搜索 栏 ， 该 搜索 栏 能 够 自动 补 全 毅 态 添加 到 页 面 的 列表 项 (该 目 
动 补 全 功能 不 需要 连接 远程 服务 来 下 载 动态 数据 )。 

可 以 将 图 标 和 图 片 添加 到 列表 项 。 以 下 代码 显示 了 如 何 将 一 个 小 图 标 添加 到 列表 项 的 
<1i><a href="..."> 

<1mg alt="™ class="01—11—1co0nNn™ src="...™ /> 

<span>Run samples</span> 
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</a></11> 
ui-li-icon 类 会 确保 图 片 左 对 齐 ; 注音 图 片 元 系 必 须 是 铁 点 的 子 节 点 。 同 样 ， 你 还 可 以 将 
文本 添加 到 列表 项 的 右 侧 。 如 果 想 要 该 文本 在 一 个 气泡 内 目 动 呈现 ， 如 图 12-8 所 示 ， 可 以 用 
ui-li-count 类 对 该 文本 进行 标记 ; 或 者 ， 也 可 以 使 用 ui-li-aside 类 。 
<11»> 
QHtml .ActionLink ("Related books"™, "Related™, "Home"™) 
<span class="u1i-l1i-count">3</span> 
</11> 
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图 12-8 在 jQM 列表 视图 中 显示 气泡 文本 


6. 流动 布局 

尽管 在 布局 中 使 用 多 个 列 对 于 移动 站 点 来 说 很 难 称 之 为 一 个 好 主意 ， 但 若 有 一 种 简单 方 
式 将 少量 元 素 并 排放 置 的 确 是 非常 棒 的 。 在 jQM 中 ， 你 会 找到 非常 基础 但 十 分 有 效 的 CSS 
网 格 实现 ， 以 及 能 自动 适应 屏幕 的 流动 布局 。 
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该 库 提 供 了 两 个 主要 的 CSS 类 : ui-grid 和 ui-block。 前 者 将 <div>( 或 <fieldset>) 标 记 为 容 
器 网 格 ， 而 后 者 将 <div> 标 记 为 子 元 素 。 不 过 ， 主 要 的 CSS 类 需要 明显 的 文字 来 分 别 表明 单 
元 格 和 位 置 的 数量 。 例 如 ，ui-grid-a 类 会 将 一 行 平均 分 成 两 块 。 弟 一 块 被 分 配给 ui-block-a 
引用 的 内 容 ; 第 二 块 被 分 配给 ui-block-b。 下 面 是 一 个 例子 : 

<fieldset class="ul-grlid-a"> 

<dliv class="™u1i-block-—a"™y> First block </divy> 
<dliyv class="™u1i-block-b"> Second block </div> 
<dlVv Class="™u1i-block-—c"™> Third block </div> 

</fieldset> 

在 这 个 例子 中 ， 还 有 分 配给 网 格 的 第 三 块 ， 该 网 格 不 能 承载 超过 两 块 ( 它 会 将 行 宽 分 成 
50/50)。 实 际 效果 是 ， 样 式 为 ui-block-c 的 第 三 个 <div> 会 男 起 一 行 显示 。 要 保持 第 三 个 子 块 
位 于 同一 行 上 ， 你 要 将 网 格 样式 修改 成 ui-grid-b， 它 会 将 网 格 平 均 分 成 三 部 分 (参见 图 12-9)。 
依 此 关 推 ，ui-grid-c 会 分 成 四 部 分 ， 而 wi-grid-d 分 成 五 部 分 。 


本 
FY ee 
(ew)|1= http://localhost:11076/Home ~ 昌 此 
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First block Second block Third block 
Navigation I 


Home 


Contact 


MS Press site 


To learn more about this book visit 


图 12-9 ”使 用 jQM 的 流动 布局 
7. 可 折 蕉 面板 
可 折 车 面板 也 很 价 单 ， 如 以 下 代码 片段 所 示 。 
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<div dqata-Trole="collapslble" data-theme="a" qdata-col1apsed="truen 
data—content-theme="e"> 
<h3>See navigation options</h3> 
<div> 
六 UL > 
</ul> 
</dliv> 
</div> 


可 折 千 角色 被 分 配给 容 右 元 素 , 它 使 用 第 一 个 <Hn> 子 元 素来 对 面板 添加 标题 并 使 其 他 内 
容 可 折 膨 。 可 以 使 用 data-collapsed 来 决定 内 容 是 人 否 要 初始 化 隐藏 。 可 以 将 样式 
data-content-theme 应 用 到 面板 内 容 ， 并 将 样式 data-theme 应 用 到 页 眉 ， 如 图 12-10 所 描绘 的 。 


To learn more about this book visit mt 


息 100% 


图 12-10 ”使 用 jQM 的 可 折 登 面板 


只 要 用 一 个 最 外 层 容器 包 带 一 系列 可 折 车 面板 ， 你 就 能 获得 一 个 可 折 又 的 部 件 。 


<div data-role="collapsible-set"> 
<div data-role="collapsible"> 
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有 
<div qdata-TolLe="col1aps1lble"> 
二 
ea 
通过 将 样式 特性 放置 在 父 容器 上 ， 所 有 的 面板 都 能 具有 相同 样式 。 否 则 ， 你 就 需要 对 每 
个 面板 单独 赋予 样式 。 


jQM 库 是 最 早出 现 的 用 于 移动 端 编程 的 框架 。 最 初 ， 它 的 推广 很 慢 ， 这 使 得 开发 人 员 转 
而 寻找 其 他 选项 和 供应 商 提 出 的 新 框架 。 经 过 几 个 版 本 的 迭代 ，jQM 已 经 变 得 更 加 好 用 并 代 
表 了 一 个 可 选项 。 

事实 上 , 即使 普通 的 JavaScript 也 是 一 个 可 选项 一 一 并 且 很 可 能 是 最 简洁 快捷 的 选项 一 一 
你 可 能 需要 四 处 寻找 一 些 框 架 来 满足 用 户 对 美观 UI 和 UX 的 要 求 。 如 果 不 使 用 jQM， 你 还 
能 依靠 什么 呢 ? 

Twitter Bootstrap 是 一 个 有 意思 的 选项 。 即 便 该 框架 并 非 专 为 移动 端 方案 而 设计 ， 但 在 需 
要 处 理 流 动 布局 和 集成 几 个 jQuery 插件 以 快速 实现 众多 jQM 特性 时 ， 它 也 能 提供 极 佳 的 功 
有 能 。 男 一 方面 ，Bootstrap 具有 完整 的 敏捷 结构 。 

相 比 之 下 , Kendo UI 是 一 个 用 于 移动 设备 的 非常 成 熟 的 框架 , 它 是 基于 HIMLS 开发 的 ， 
并 且 经 过 全 新 设计 以 便 为 不 同类 别 设 备 生 成 高 质量 和 漂亮 的 UI。 Sencha 也 能 用 于 达成 这 些 类 
似 目 标 。 新 框架 的 名 单 正 变 得 越 来 越 长 。 

如 果 对 各 种 框架 感到 有 些 困惑 ， 别 担心 : 不 只 你 这 样 觉 得 。 通 常 来 说 ， 没 有 哪个 框架 具 
有 显著 的 优势 。 如 果 发 现 一 个 特定 框架 很 适合 你 ， 那 就 持续 使 用 它 吧 。 男 一 方面 ， 如 果 使 用 
的 框架 不 太 适 用 ， 也 能 很 容易 找到 一 个 更 好 的 框架 等 着 你 下 载 。 


12.1.4 ”Twitter Bootstrap 概览 


如 今 所 有 网 站 都 被 期 望 是 啊 应 式 的 一 至 少 要 能 啊 应 条 主屏 幕 宽 度 的 变化 。 作 为 开发 团 
队 的 一 员 ， 你 有 两 种 方式 达成 此 目的 : 可 以 简单 地 从 供应 商 处 订购 一 个 HTML 啊 应 模板 (并 
透明 公开 地 实现 细节 )， 或 者 可 以 进行 模板 的 自主 开发 。 在 后 一 种 情形 中 ， 你 会 使 用 哪个 框架 
呢 ? Bootstrap 大 概 是 你 首先 会 想到 的 框架 ， 但 它 不 是 唯一 的 一 个 。 

其 他 同样 流行 的 有 效 啊 应 式 框架 有 Foundation(http://foundation.zurb.com)、Skeleton(http:// 
getskeleton.com) 和 Gumby(http://www.eumbyframework.com) 。 可 以 在 http://mashable.com/ 
2013/04/26/css-boilerplates-frameworks 找到 CSS 啊 应 式 框架 和 目 定 义 开 发 方法 的 快速 指南 。 
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Bootstrap 正 迅速 变 成 现代 Web 开发 的 实际 标准 ， 特 别 是 现在 Visual Studio 2013 将 其 集 
成 到 了 ASPNET MVC 应 用 程序 的 默认 模板 中 。 使 用 Bootstrap， 可 以 轻易 地 安排 网 页 的 UI、 
让 其 可 啊 应 ， 以 及 提供 高 级 导航 和 图 表 功 能 。Bootstrap 本 质 上 由 一 个 CSS 文件 和 一 个 可 选 的 
JavaScript 文件 构成 。 应 用 到 HIML 页 面 元 素 后 ，Bootstrap 的 CSS 类 可 以 改变 当前 DOM 的 
外 观 ， 并 且 最 棒 的 是 代码 看 起 来 仍然 与 普通 HIML 一 样 。 还 有 一 个 额外 的 好 处 ， 就 是 在 大 多 
数 任务 中 你 甚至 都 不 需要 额外 的 JavaScript。 


1. 设置 Bootstrap 


Bootstrap 是 以 模块 来 表述 的 ， 它 最 初 是 作为 LESS 文件 集合 来 开发 的 。 基 本 上 你 要 让 每 
个 组 成 Bootstrap 框架 的 模块 具有 一 个 LESS 文件 ， 这 些 模块 包括 : 表单 、 按 钮 、 导 航 、 对 话 
框 等 。LESS 文件 是 对 普通 CSS 语法 的 抽象 ， 这 使 可 以 声明 CSS 文件 最 终 是 什么 样 的 。 可 以 
将 LESS 看 作 是 一 种 编程 语言 , 它 能 在 编译 时 生成 CSS。 为 此 , 使 用 LESS, 你 就 能 使 用 变量 、 
国 数 以 及 运算 人 符 一 大 大 精 向 了 人 蚀 建 较 大 和 复杂 CSS 样式 表 的 过 程 。 

通过 对 原始 LESS 文件 进行 修改 ， 开 有 友人 员 能 随意 目 定 义 Bootsttap。 如 有 果 不 适 应 LESS 
语法 ， 还 可 通过 使 用 一 个 配置 引擎 将 轻 量 级 的 自 定 义 应 用 到 Bootstrap。 如 果 不 介 意 Bootstrap 
的 内 部 构成 ， 并 且 只 想 要 最 小 化 下 载 量 ， 则 可 以 选取 核心 GitHub 存储 库 中 的 CSS 文件 ， 选 
出 你 要 使 用 的 模块 即 可 。 可 以 从 http://getbootstrap.com 处 下 载 Bootstrap。 

最 近 ，TWwitter 发 布 了 Bootstrap 的 3.0 版 本 ， 其 中 引入 了 一 些 新 元 素 ， 但 同时 还 变更 了 现 
有 样式 的 作用 。 如 果 有 一 个 Bootstrap 2.x 站 点 ， 在 升级 之 前 请 租 陪 一 下 http://getbootstrap.com 
的 迁移 指南 ; 一 般 来 说 ， 你 可 能 会 遇见 一 些 重 大 变更 。 

要 开始 使 用 Bootstrap， 只 需要 将 以 下 代码 添加 到 空 HTML 页 面 的 <head> 节 即 可 : 

<meta name="viewport™" content="wldth=dqevlce-wldth，1nlt1al-scale=]1 .0"> 

<link href="bootstrap.min.css" rel="stylesheet"™" media="screen"> 

viewport 元 标签 会 将 浏览 器 视窗 的 宽度 设置 成 实际 的 设备 冤 度 ， 并 将 缩放 级 别 设置 成 普 
通 。<link> 元 素 仅 引入 了 Bootstrap 样式 表 的 压缩 版 本 。 你 能 够 在 http://getbootstrap.com 处 下 
载 Bootstrap CSS 文件 ， 或 者 从 一 个 已 知 的 内 容 分 发 网 络 (CDN) 处 链接 这 些 文件 。 


<11InK rel="stylesheet" 
href="//netdna.bootstrapcdn.com/bootstrap/3.0.0/css/bootstrap.min.css"> 


你 还 需要 链接 jQuery 库 。 这 对 于 制作 不 带 有 像 下 拉 这 蛙 或 弹出 对 话 框 这 些 额 外 功能 的 啊 
应 式 模板 就 足够 了 。 如 果 打 算 引 入 一 些 需要 客户 端 脚 本 的 最 高 级 功能 ， 你 还 应 该 添加 
Bootstrapjs 文件 ,可 以 在 下 载 包 中 找到 该 文件 。 如 果 选 取 一 个 特殊 的 Bootstrap 主题 ， 那 么 还 
要 将 该 CSS 文件 添加 到 页 面 。 可 以 在 http://wrapbootstrap.com/themes 处 找到 免费 的 Bootstrap 
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请 记 住 ， 在 Internet Explorer 的 旧版 本 兼容 模式 下 不 文 持 Bootstrap。 确 保 页 面 能 在 最 好 
的 可 能 呈现 模式 中 浏览 的 最 佳 方法 是 ， 将 以 下 <meta> 标 签 添加 到 你 的 页 面 中 : 


<meta http-equiv="X-UA-Compatible" content="IE=edge"> 


Bootstrap 的 CSS 类 使 用 了 最 新 的 CSS 特性 (比如 圆 角 ), 这 些 特性 在 旧版 本 的 浏览 器 上 可 
能 无 法 使 用 。 由 Bootstrap 部 分 文 持 的 旧版 本 浏览 器 的 例子 就 是 Internet Explorer 8。 


2. 网 格 系统 


Bootstrap 中 的 啊 应 性 是 通过 一 些 断 点 来 达成 的 。 第 一 个 断 点 被 放置 在 480 像素 ， 这 也 是 
默认 的 。 其 他 的 断 点 放置 在 768 像素 (大 多 数 平板 电脑 )、 用 于 蝎 面 端 992 像素 ， 以 及 用 于 大 
屏 妖 的 超过 1200 像 隶 的 断 点 。Bootstrap 的 所 有 内 容 通 常 都 是 根据 以 下 模式 来 布局 的 : 


container> row > span 


上 述 每 个 单词 指 的 都 是 一 个 Bootstrap 类 名 称 ， 你 通常 要 将 其 应 用 到 一 个 <div> 元 素 。 尤 
其 是 ，container 会 管理 页 面 的 宽度 和 内 边 距 。row 样式 会 确保 内 容 被 放置 在 同一 行内 ， 并 确 
保 多 个 行 垂直 摆 放 。 如 果 没 有 row 元素 ， 则 容器 中 的 所 有 内 容 都 将 水 平 排列 ， 并 且 当 到 达 屏 
幕末 端 时 进行 换行 。 最 后 ，span 样式 会 将 行 中 的 内 容 识别 成 一 个 整 块 。 一 般 来 说 ， 如 果 选 择 
一 个 不 同 于 container-row-span 的 组 合 ， 结 果 将 不 可 了 预测。 然而， 如 果 能 设法 得 到 你 确实 想 要 
的 ， 束 无 须 在 意 其 是 否 符 合 建议 的 关系 。 

<div class="container™"> 

<dliv Class="row"> 


i 
<diy class="row"> 
ee 
</d1liv> 
一 行 的 内 容 就 是 一 个 流动 网 格 系统 的 主体 ， 当 设备 尺寸 增 大 时 它 会 放大 到 12 列 。 你 要 
为 一 个 行 单元 格 使 用 col-md-N 样式 ， 其 中 N 表示 网 格 中 要 使 用 的 单元 格 数量 。 此 外 ， 你 还 
可 以 使 用 不 同 大 小 的 列 , 这 些 列 要 使 用 像 col-lg-N( 大 屏幕 )、col-sm-N( 平 板 电 脑 ) 和 col-xs-N( 智 
能 手机 ) 这 样 的 样式 。 下 面 是 一 个 例子 : 
<div class="container™"> 
<diyv class="row"> 
<diy class="col-md-3"> 


</d1iv> 
<dlVv Class="col—md—3"> 
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</d1V> 
<QLV class="col—md— 3"> 
</div> 
</dliv> 
</div> 
上 面 的 代码 片段 创建 了 一 个 带 有 三 个 水 平 排列 的 <div> 元 素 的 块 元 素 ， 平 均 占据 整个 空 
则 。 每 个 <div> 中 的 内 容 都 会 在 可 用 空间 里 居中 。 


3. 可 般 本 


通过 使 用 其 后 跟随 有 更 多 指定 样式 的 nav 基 类 ， 可 以 轻易 地 将 <div> 元 素 转变 成 导航 栏 。 
下 面 显 示 了 如 何 创 建 一 个 顶级 标签 菜单 。 
<ul class="nav nav-tabs"> 
<11 class="active"><a href="#">O0ne</a></l11> 
<1li><a href="#">Two</a></11> 
<li><a href="#">Three</a></11> 
</ul> 
辅助 样式 有 nav-tabs、nav-pills、nav-stacked 以 及 nav-justified。 它 们 最 终 会 生成 图 形 化 效 
果 ， 比 如 药丸 (间隔 均匀 的 按钮 )、 生 直 堆 著 块 ， 以 及 水 平 居 中 块 。 
navbar 样式 会 为 网 站 生成 啊 应 式 导 航 页 眉 一 有 一 些 与 经 典 工具 栏 很 相似 。 非 党 有 意思 
的 是 ，Bootstrap navbars 在 小 视图 中 会 初始 化 显示 成 折 县 状态 ， 而 在 有 足够 空间 且 视 窗 尺 十 
变 大 时 会 水 平展 开 。 所 有 这 些 行 为 都 是 自动 并 且 内 置 在 Bootstrap CSS 中 的 。 如 果 还 未 能 说 服 
你 的 话 ， 请 考虑 一 下 ， 这 个 样式 会 让 你 (不 受 限 制 ) 得 到 水 平 汪 单 的 典型 行为 ， 它 能 折 骆 成 几 
条 垂直 线 并 且 在 宿主 窗口 大 小 可 容纳 的 情况 下 展开 。 同 样 , 仅 通 过 使 用 额外 的 navbar-fixed-top 
或 navbar-fixed-bottom 样式 ， 可 以 轻易 地 将 navbar 的 位 置 固 定 在 页 面 项 部 或 奔 部 。 
有 了 时候， 导航 栏 用 于 承载 应 用 程序 分 支 结 构 中 页 面 的 逻辑 路 径 。 这 称 为 Bootstrap 中 的 面 
包 届 导航 。 以 下 是 你 需要 的 代码 : 
<O class="breadcrumb"> 


<1li><a href="i">One</as</11> 
<11 class="active™"™><a href="#">Two</a></11> 


<11>Three</11> 

</ol> 

最 后 的 结果 是 自动 包括 链接 和 分 隔 符 的 标记 字符 串 。 你 不 必 编 写 一 行 脚本 或 标记 就 能 完 
成 该 呈现 。 

最 终 ， 就 页 面 项 部 而 言 ， 你 还 可 以 使 用 page-header 样式 。 它 是 <h1> 标 记 元 素 的 基本 包 


装 ， 会 识别 内 容 中 的 <small> 元 妹 。 其 民 好 效果 是 ， 子 的 小 文本 会 目 动 应 用 不 同 的 样式 以 便 反 
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映 出 下 级 标题 。 
4. 用 图 标 和 图 片 修饰 UI 


包含 Bootstrap 文件 的 压缩 文件 还 包括 一 个 效 满 符号 图 标的 目录 ， 该 目录 可 从 
http://glyphicons.com 获得 ， 并 且 是 免 许 可 的 。 可 以 在 任何 需要 标记 的 位 置 使 用 这 些 图 标 ;， 不 
需要 <img> 元 素 。 最 通常 的 情况 是 ， 你 要 将 符号 包 站 在 <span> 标 签 集中 并 将 其 与 一 些 自 由 文 
本 结合 ， 如 下 所 示 : 


<span class="glyphicon glyphicon-wrench"></span> Tools 


该 标记 的 效果 是 在 文本 “Tools” 之 前 显示 扳手 符号 。 可 以 在 <div> 元 素 中 使 用 它 ， 并 轻 
易 地 将 该 容器 用 作 按 钮 样式 。 值 得 注意 的 是 ， 你 需要 指定 两 个 类 : 基础 glyphicon 类 ， 其 后 
跟随 有 标识 出 你 想 要 的 图 标的 具体 类 。 

在 响应 式 模板 中 ， 图 片 在 某 种 程度 上 会 成 为 瓶颈 ， 因 为 它们 对 于 某 些 屏幕 尺寸 来 说 可 能 太 
大 并 且 会 浪费 带宽 。 此 外 ， 当 图 片 太 大 时 ， 它 会 截断 屏幕 并 导致 难看 的 UI。 在 Bootstrap 3 中 ， 
无 须 做 任何 处 理 你 就 能 轻易 地 让 <img> 标 签 成 为 响应 式 的 ， 只 要 添加 img-responsive 类 即 可 。 


<img Src="..." Class="img-responsive"> 
其 效果 如 同 添加 了 以 下 样式 : 


max—wlidth: 100%; 
height: auto; 


这 样 一 来 ， 图 片 大 小 就 能 很 好 地 缩放 成 父 元 素 的 尺寸 。 请 注意 这 一 技巧 在 下 载 时 并 不 适 
用 。 它 只 会 确保 图 片 被 很 好 地 呈现 并 适当 收缩 ， 丰 过， 下载 的 图 片 尺寸 总 是 相同 的 。 


5. 下 拉 菜 单 


下 拉 菜 单 在 计算 机 UI 中 并 非 新 事物 ， 但 它们 仪 在 最 近 才 开始 在 网 页 中 变 得 常见 。 
HTMI 一 一 就 连 最 新 的 HTML5 也 是 如 此 一 一 没有 语法 元 素 能 用 来 在 单 击 按钮 时 生成 下 拉 菜 
单 。 要 达成 该 任务 , 可 以 混合 使 用 所 有 工具 : CSS、 特 设 标记 以 及 jQuery 插件 。 使 用 Bootstrap 
3， 所 有 的 这 些 基本 细节 都 会 对 视图 完全 隐藏 。 下 面 的 代码 显示 了 网 页 中 需要 的 标记 ， 以 实现 
放置 一 个 按钮 并 将 下 拉 菜单 附加 到 该 按钮 。 

<div class="dropdown"> 

<button data-toggle="dropdown">Actions</button> 
<Ul1 class="dropdown—menu" role="menu"> 
<11 role="presentation"™"> 
<a role="menuitem" tabindex="-1" href="#">0ne</a></11> 
<11 role="presentation"™"> 
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<a TO1Le="menultemn tabijndex="—1"™ href="#">Two</a></l11> 
<11 role="presentation"™"> 
<a role="menuitem" tabindex="—1"™ href="#">Three</a></l11> 
<]11 role="presentation™" class="divider"></11> 
<11 role="presentation"™"> 
<a role="menuitem™" tabijndex="—1"™ href="#">Four/a></l11> 
</ul> 
</d1lv> 


正如 你 所 看 到 的 ， 所 有 标记 都 被 包装 在 样式 为 dropdown 类 的 <div> 元 素 中 。dropdown 类 
是 在 Bootstrap CSS 文件 中 定义 的 ， 这 个 类 会 为 实际 UI 和 相关 行为 做 好 基础 准备 。 在 某 种 程 
度 上 ， 你 能 使 用 一 些 伪 标 记 来 重 写 上 面 的 全 部 HTML 标记 ， 如 下 所 示 : 


<dropdown> 
<trigger>Actions</trigger> 
<dropdown—menu> 
<menuitem href="#">O0ne</menuitem> 
<menuitem href="#">Two</menuitem> 
<menuitem href="#">Three</menuitem> 
<menudivider /> 
<menuitem href="#">Four</menuitem> 
</dropdown—menu> 
</dropdown> 


开发 人 员 需 要 做 的 就 是 定义 目标 URL 以 及 其 后 的 代码 。 它 可 以 是 茶 些 内 部 HTML 元 素 
的 散 列 标签 ， 或 者 它 也 可 以 是 指向 某 些 JavaScript 代码 或 外 部 URL 的 指针 。 图 12-11 显示 了 
下 拉 标 记 的 效果 。 


图 12-11 关联 到 按钮 的 下 拉 六 蛙 


下 拉 菜单 有 许多 其 他 部 分 可 以 自 定义 。 例 如 , 你 能 在 可 单 击 菜单 项 之 间 添 加 一 种 注释 行 。 
你 需要 做 的 只 是 定义 一 个 常规 <li> 元 素 并 为 其 分 配 dropdown-header 类 。 


<11 Frole="presentat1lon" class="dqropdown-header">3Spec1l1al actions</11> 


可 以 通过 为 相应 <li> 元 素 添加 disabled 类 的 样式 来 禁用 一 个 菜单 项 ， 如 下 所 示 : 
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<11 role="presentation™" class="disabled"> 
<aa role="menuitem™ tabindex="—1"™ href="#">Four/a> 
</11> 


要 触发 该 菜单 ， 你 需要 一 个 <button> 或 一 个 <a> 元 素 ， 并 使 用 设置 为 dropdown 值 的 
data-toggle 特性 对 其 进行 配置 。 在 Bootstrap 中 ， 你 要 使 用 data-toggle 特性 来 请 求 某 些 元 素 上 
的 单 击 行为 。 该 特性 的 值 是 一 些 预定 义 关 键 字 之 一 ， 它 主要 是 指示 框架 选择 一 个 特定 jQuery 
插件 来 实际 执行 该 藻 差 事 。 当 你 想 要 通过 dropdownjQuery 插件 来 完成 下 拉 行 为 的 话 ， 就 要 使 
用 关键 字 “dropdown”。 


6. 按钮 分 组 


通常 ， 网 页 需要 显示 一 些 在 某 种 程度 上 相关 的 按钮 。 你 当然 可 以 单独 处 理 这 些 按钮 并 根 
据 你 的 喜好 为 其 添加 样式 。 不 过 ， 几 年 前 ，iOS UI 引入 了 分 段 按 钮 的 概念 ， 如今， 就 算 不 是 
必要 和 条件， 分 段 按钮 也 是 值得 拥有 的 特性 。 分 段 按钮 本 质 上 是 一 组 按钮 ， 这 组 按钮 能 单独 发 
挥 作 用 但 呈现 为 单个 条 状 按钮 。 其 最 好 的 效果 是 ， 该 条 状 按钮 中 的 第 一 个 和 最 后 一 个 按钮 具 
有 圆 角 ， 而 中 间 的 按钮 完全 是 方形 的 。 在 Bootstrap 中 ， 你 要 使 用 以 下 基于 HTML 的 标记 : 


<div class="btn-group"> 
<button type="button" class="btn btn-success">Agree</button> 
<button type="button™" class="btn btn-default">Not sure</putton> 
<button type="button™" class="btn btn-danger">Disagree</button> 


</d1liv> 
正如 你 所 看 到 的 ， 上 面 的 代码 真 的 差不多 就 是 几 个 单独 的 按钮 而 已 ， 每 个 按钮 都 有 其 自 
己 的 单 击 处 理 程序 ， 这 些 处 理 程序 要 么 通过 onclick 特性 显 式 添加 ， 要 么 通过 jQuery 隐 式 添 


加 。 要 具有 一 个 按钮 分 组 ， 你 需要 做 的 就 是 将 按钮 清单 包装 到 样式 为 btn-group 的 <div> 元 素 
中 。 图 12-12 显示 这 一 效果 。 


图 12-12 iOS 分 段 按钮 的 HIML 对 应 项 


每 个 按钮 的 样式 都 是 通过 btn 类 单独 赋予 的 ; 可 以 通过 btn-xxx 类 添加 额外 的 特性 来 改变 
背景 色 : success、danger、warning、info。 使 用 btn-group-lg、btn-group-sm 或 btn-group-xs 这 
样 的 附加 类 来 控制 分 组 中 按钮 的 大 小 。 默 认 情况 下 ， 按 钮 都 是 水 平 堆 各 的 。 要 让 按钮 垂直 扒 
登 ， 只 需要 使 用 btn-group-vertical 类 即 可 。 可 以 将 多 个 分 组 包 六 到 一 个 按钮 工具 栏 中 ， 以 便 
并 排放 置 这 些 分 组 


<Q1 Class="ptn-toolbar™"y> 
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<div class="btn-group">...</div> 
<div class="btn—group">...</div> 
<div class="btn-group">...</div> 


</div> 
最 后 ， 可 以 幅 套 按钮 分 组 。 当 一 个 分 组 要 作为 下 拉 列 表 呈 现时 ， 嵌 套 就 特别 有 用 。 下 面 
是 一 个 示例 : 


<div class="btn-group"> 
<button type="button™" class="btn btn-default">One</button> 
<button type="button™" class="btn btn-default">Two</button> 
<div class="btn-—-group"> 
<button type="button" class="btn dropdown-togqgle" data-toggle="dropdown"> 
Numbers 
<span class="caret"></span> 
</button> 
<UL class="dropdown—menu"> 
<11><a href=—"#">1</a></11> 
<li><a href="#">2</a></11> 
<l1li><a href=—"#">3</a></11> 
</ul> 
</d1liv> 
</div> 


该 分 组 的 前 两 个 项 是 普通 按钮 ， 然 后 是 一 个 骸 套 分 组 。 该 按钮 分 组 由 一 个 附加 了 下 拉 亲 
单 的 按钮 组 成 。 应 当 注 意 的 是 ， 该 按钮 的 特征 是 具有 一 个 插入 符号 分 段 ， 直 观 地 表示 有 更 多 
可 用 的 选项 。 被 分 配 到 按钮 中 <span> 元 素 的 caret 类 会 呈现 一 个 向 下 的 箭头 ， 类 似 于 经 典 的 
Windows 下 拉 前 尖 。 


注意 : 
Bootstrap 所 具有 的 特性 远 远 不 止 此 处 所 讨论 的 。 要 了 解 更 多 特性 ， 请 访问 http:// 
getbootstrap.com。 


12.2 ”为 已 有 站 扣 湛 加 移动 功能 


规划 移动 站 点 的 最 重要 任务 是 选择 用 例 。 不 过 ， 这 并 不 是 说 开发 完整 站 点 或 其 他 类 型 的 
应 用 程序 时 用 例 选择 不 重要 。 只 是 因为 移动 应 用 程序 和 站 点 在 结构 上 是 围绕 一 些 (精心 选择 的 ) 
用 例 来 构建 的 。 有 时 候 ， 即 使 你 从 已 有 昌 面 站 点 中 选取 用 例 ， 你 用 来 为 移动 用 户 实 现 它 的 方 
法 也 可 能 需要 大 量 修改 一 一 可 能 是 一 个 不 同 的 UI， 也 可 能 是 一 个 不 同 的 工作 流 。 在 面临 为 移 
动用 户 提供 完全 不 同 视 图 的 情况 时 ，RWD 并 不 总 是 像 你 需要 它 的 那样 强 有 力 。 
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所 以 ， 不 似 很 多 人 认为 的 那样 ， 退 党 的 结 末 是 你 需要 一 组 用 于 全 部 浏览 副 的 忠和 甸 ， 然 后 
将 多 组 页 面 用 于 你 要 文 持 的 每 种 移动 设备 。 现 实情 况 是 ， 桌 面 端正 变 成 特殊 情况 。 你 要 如 何 
设法 让 这 多 组 页 面 看 起 来 像 单 个 站 点 呢 ? 在 第 13 章 中 ,我 会 讨论 由 ASPNET MVC 提供 的 根 
据 请 求 设备 将 用 户 路 由 到 特定 视图 的 原生 工具 。 


然而 有 时 候 ， 更 简单 的 做 法 是 构建 一 个 用 于 移动 用 户 的 从 头 开 始 设计 的 独立 网 站 ， 然 后 
通过 使 用 HTTP 模块 和 cookies 将 这 两 个 站 点 连接 起 来 。 


12.2.1 将 用 户 路 由 到 正确 的 站 点 
因为 你 现在 拥有 两 个 单独 的 站 点 ， 所 以 需要 一 种 自动 化 机 制 根据 请 求 设备 的 性 能 将 用 户 


切换 到 合适 的 站 点 。 如 果 宿 主 名 称 属于 桌面 站 点 且 请 求 浏览 器 被 检测 为 桌面 浏览 器 ， 则 一 切 
将 如 预期 运行 。 否 则 ， 用 户 将 看 见 一 个 目标 页 面 ， 该 页 面 会 提示 用 户 他 正 试图 用 移动 设备 访 
问 桌面 站 点 。 此 处 用 户 有 机 会 可 以 保存 其 偏好 以 便 将 来 出 现 类 似 的 情形 时 使 用 。 其 偏好 会 被 
存储 到 cookie 并 在 下 一 次 检查 。 

1. 路 由 算法 


如 果 请 求 涉及 移动 站 点 的 URL 而 用 户 似 乎 是 在 使 用 昌 面 浏览 器 ， 可 以 考虑 显示 另 一 个 
着 陆 页 面 ， 而 不 是 简单 让 该 请 求 顺利 通过 。 最 后 ， 如 果 一 个 请 求 是 从 移动 设备 发 出 且 目 标 是 
移动 站 点 时 ， 它 将 如 预期 一 样 被 处 理 ; 也 就 是 说 ， 通 过 检查 设备 性 能 并 确定 最 合适 的 视图 即 
可 。 图 12-13 显示 了 该 算法 图 表 。 


为 桌面 用 户 检测 设备 性 能 
显示 着 陆 页 面 并 为 合适 的 
内 容 提供 服务 


为 请 求 页 面 为 移动 用 户 
提供 服务 显示 着 陆 页 面 


图 12-13 桌面 /移动 视图 切换 器 算法 
注意 : 
常常 有 一 种 错误 ， 就 是 认为 桌面 和 移动 页 面 之 间 存 在 一 对 一 的 关系 。 这 种 情况 有 可 能 发 
生 ， 但 它 不 应 被 认为 是 通常 会 出 现 的 情形 。 这 里 所 说 的 “页 面 对 应 关系 ”， 指 的 是 这 两 个 应 用 
程序 都 能 为 相同 的 URL 提供 服务 ; 我 并 没 暗示 每 个 页 面 都 会 实际 提供 的 任何 相关 内 容 . 
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你 要 如 何 实现 图 12-13 中 描绘 的 算法 呢 ? 
2. 实现 路 由 算法 


在 ASPNET 中 ， 实 现 这 一 路 由 算法 的 原生 工具 是 ， 使 用 一 个 作用 于 两 个 站 点 的 HITP 
模块 并 捕获 BeginRequest 事件 。 该 模块 会 使 用 普通 的 重 定向 ， 或 者 可 能 的 话 ， 使 用 URL 重 
写 来 酌情 变更 目标 页 面 。 

以 下 是 在 桌面 站 点 中 实现 前 述 算法 的 一 些 代码 : 


public class MoblileRouter : IHttpModule 


{ 


private const string FullSsiteModeCookie = "FullSsiteMode™"; 
public vold Dispose() 


{ 
} 
public void Init (HttpApplication context) 
{ 

context .BeginRequest += OnBeginRequest; 
} 


private static void OnBeginRequest (Object sender, EventArgs e) 
{ 
var app = sender as HttpApplication; 
1f (app == null) 
throw new ArgumentNullException ("sender").; 


Var lsMobileDevice = IsRequestingBrowserMoblile (app); 


// Mobile on desktop site, but FULL-SITE flag on the query string 
1f (isMobileDevice && HasFullSsSiteFlag (app)) 
{ 
app.Response.AppendCookie (new HttpCookie (FullsSiteModeCookie)); 
return; 


// Mobile on desktop site, but FULL-SITE cookie 
1f (isMobileDevice && HasFullsiteCookie (app)) 
return; 


// Mobile on desktop site => landing Pade 
1f (i1sMoblilleDevlice) 
ToMobileLandingPage (app); 
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#region Helpers 
private static Boolean IsRequestingBrowserMobile (HttpApplication app) 
{ 

return app.Context.Request.IsMobileDevice ();} 


private static Boolean HasFullSsiterFlag (HttpApplication app) 


{ 
Var fullsiteFlag = app.Context.Request.Querystring["m"]; 
1f (!String.IsNullorEmpty (fullsiterlag)) 
return String.Equals (fullsiteFlag, "“f", StringComparison. 
InvariantCulturelIgnoreCase);} 
return false; 
} 


private static Boolean HasFullSsSiteCookie (HttpApplication app) 

{ 
Var Cookle = app.-Context .Request .Cookles[Eul1S1IteModeCooklel]:; 
return Cookle != null; 


private static void ToMobileLandingPage (HttpApplication app) 


{ 
var landingPage = ConfigurationManager.App3Settings 
["MobileLandingPage"]; 
1f (!sString.IsNullorEmpty (landingPage)) 
app .Context .Response.Redirect (landingPage); 
} 
#endreglion 


} 

在 其 被 安装 到 加 面 站 点 后 ， 该 HTTP 模块 会 捕获 每 一 次 请 求 并 检查 请 求 浏览 器 。 如 果 浏 
览 器 运行 在 移动 设备 中 ， 则 该 模块 会 重 定 向 到 指定 的 目标 页 面 。 该 目标 页 面 应 该 是 一 个 面 回 
移动 优化 的 页 面 ， 其 实质 是 提供 两 个 链接 ， 分 别 链接 到 昌 面 站 点 的 首页 和 移动 站 点 的 首页 。 
图 12-14 显示 了 在 旧 的 Android 2.2 设备 上 浏览 的 示例 目标 页 面 。 
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http://www.easycourt.net/contoso.., () 


EasyCourt Mobile 


You are requesting a page that 
doesn't seem to be ideal for 
the device you're using. 


Would you rather like to switch 
to the mobile version of the 
site? 


Full site Mobile site 


图 12-14 在 Android 2.2 设备 上 浏览 的 示例 移动 站 点 的 着 陆 页 面 
3. 跟踪 所 选 路 由 


如 果 用 户 坚 持 要 浏览 完整 站 点 , 你 就 不 能 仅仅 重 定向 到 普通 的 主页 面 了 。 就 其 本 质 而 言 ， 
该 HTTP 模块 将 解析 这 一 新 请 求 并 再 次 重 定向 到 移动 着 陆 页 面 。 在 该 着 陆 页 面 中 ， 可 以 简单 
地 添加 一 个 指定 查询 字符 串 参数 ， 以 便 由 该 HTTP 模块 在 连续 的 请 求 上 检测 。 以 下 是 产生 图 
12-14 所 示 页 面 的 实际 链接 : 


<a href="http://.../?2m=f">Full site</a> 


你 要 负责 定义 该 得 询 字 符 串 语法 ; 在 这 个 例子 中 ，m 代表 模式 ， 而 f 代 表 完 整 。 不 过 ， 
该 任务 还 没有 完成 。 此 时 ， 用 户 导 航 到 了 站 点 首页 。 那 其 他 请 求 久 如何 昵 ? ? 实际 上 ， 那 些 请 
求 将 由 该 HTTP 模块 解析 。 通 过 添加 cookie， 你 就 能 为 该 HTTP 模块 提供 额外 的 信息 轧 ， 这 些 
信息 与 有 意 从 移动 设备 提交 请 求 到 果 面 站 点 有 关 。 

用 户 要 如 何 切换 回 移动 站 点 呢 ? 理想 情况 下 ， 上 有 其 有 关联 移动 站 点 的 所 有 果 男 站 操 部 应 该 
提供 一 个 显而易见 的 链接 来 切换 到 移动 版 本 (反之 在 移动 设备 上 浏览 完整 站 点 时 也 应 如 此 )。 

人 否则， 在 cookie 失效 或 被 清除 之 前 ， 用 户 将 无 法 在 完整 站 点 或 移动 站 点 之 间 进 行 选 择 。 要 清 
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除 cookies， 用 户 要 使 用 移动 浏览 左 的 设置 页 面 。 
4. 微调 配置 文件 


你 要 在 哪里 放置 着 陆 页 面 呢 ?” 它 位 于 吕 面 站 点 还 是 移动 站 点 上 ? 通常 , 这 不 重要 ; 但 是 ， 
如 果 将 其 放置 在 移动 站 点 上 ， 你 就 真 的 能 实现 一 种 方案 ， 在 其 中 部 署 一 个 具有 全 部 所 需 路 由 
逻辑 的 移动 站 点 ， 而 无 须 使 用 已 有 果 面 站 点 的 代码 库 。 

不 过 , 蜗 面 站 点 需要 在 其 配置 中 做 一 些 修改 。 具体 来 说 , 你 要 编辑 扣 面 站 点 的 web.config 
文件 ， 并 在 Bin 文件 夹 中 部 署 一 个 带 有 该 HTTP 模块 的 库 。 不 要 对 源 代码 进行 任何 修改 。 以 
下 是 将 路 由 HTTP 模块 添加 到 朱 面 站 点 的 配置 脚本 : 

<System.webServer> 

<modules> 


<add name="MobileRouter™ type="...™" /> 
</modules> 


</system.webServer> 


请 记 住 ， 欢 迎 页 面 应 该 总 是 可 见 的 ， 并 且 绝 不 应 该 对 其 进行 身份 验证 。 根 据 你 部 署 移动 
站 点 的 方式 一 一 单独 的 根 站 点 /应 用 程序 或 者 子 应 用 程序 /目录 一 一 你 可 能 需要 微调 移动 站 点 
的 web.config 文件 ， 以 停 用 该 HTTP 模块 。 如 果 移 动 站 点 是 一 个 单独 的 应 用 程序 ， 那 么 它 需 
要 其 自己 的 完全 配置 有 该 HTTP 模块 的 web.config 文件 。 不 过 ， 如 果 移 动 站 点 在 桌面 站 点 中 
是 作为 子 目 录 承 载 的 ， 则 它 就 会 继承 父 站 点 ( 果 面 站 点 ) 的 配置 设 定 ， 包 括 该 HITP 模块 。 要 
加 速 处 理 请 求 ， 你 可 能 会 想 要 在 移动 站 点 中 禁用 该 HTTP 模块 。 

以 下 是 移动 站 点 的 web.config 文件 中 需要 的 配置 脚本 。 该 脚本 会 清除 移动 站 点 所 需 的 
HTTP 模块 列表 。 


<System.webServer> 


<modules> 
<Clear /> 
</modules> 


二 
此 外 ， 你 需要 指示 父 应 用 程序 /站 点 显 式 停止 默认 的 设置 继承 链 。 以 下 是 所 需 的 代码 : 


<location path=".™" inheritIinChildApplications="false"> 
<System.webServer> 
<modules> 
<add name="MobileRouter™ type="...™ /> 
</modules> 
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</system.webServer> 

</location> 

男 外 请 注意 ， 当 移动 站 点 是 一 个 子 应 用 程序 /目录 时 ， 它 会 继承 一 串 无 须 重 复 (比如 ， 连 
接 字符 串 和 成 员 资格 提供 程序 ) 的 设置 (那些 继承 性 未 被 关闭 的 节 )。 


注意 : 
该 示例 基于 默认 的 互联 网 信息 服务 (IIS)7.5 配置 , 也 就 是 基于 集成 管道 模式 。 如果 使 用 的 
是 经 典 管 道 模 式 , 就 应 该 在 systemweb/httpModules 节 上 而 非 system.webServer/modules 上 操作 。 


12.2.2 ”从 移动 端 到 设备 


直到 两 三 年 前 ， 网 站 都 是 用 于 桌面 端 浏 览 器 或 移动 端 浏览 器 的 。 然 而 ,，“ 移 动 端 ” 一 词 
已 经 日 益 模 糊 了 。 移 动 端 指 的 是 智能 手机 还 是 平板 电脑 ， 又 或 者 两 者 都 是 ? 另外， 迷你 平板 
或 大 屏 智能 手机 呢 ? 普通 手机 又 是 不 是 移动 端 呢 ? 智能 电视 呢 ? 重点 是 ， 你 真 的 需要 开始 考 
虑 多 种 设备 的 问题 ， 并 决定 你 的 RWD 是 否 能 达成 你 的 目标 或 者 是 否 需要 寻求 其 他 更 有 效 的 
设备 检测 方法 。 针 对 这 一 点 来 说 ， 将 单个 “移动 端 ”站 点 添加 到 已 有 的 桌面 端 站 点 的 方法 看 
起 来 就 像 是 临时 解决 方案 或 者 说 仅仅 是 补丁 式 解决 方案 。 

合理 的 情形 是 ， 你 应 该 至 少将 “移动 端 ” 一 词 分 成 两 类 : 智能 手机 和 平板 电脑 。 另 外 还 
建议 增加 其 他 类 别 ， 比 如 大 屏 设备 (如 智能 电视 ) 和 传统 旧 款 手机 ， 但 在 所 有 应 用 程序 中 都 并 
非 强制 必须 的 。 

如 果 选 择 一 个 与 已 有 桌面 站 点 密切 关联 的 移动 站 点 ， 这 是 否 意味 着 你 需要 具有 两 个 或 三 
个 额外 的 站 点 呢 ? 当 对 多 种 类 别 设备 的 支持 迫在眉睫 时 ， 你 应 该 研究 多 设备 设计 。 从 概念 上 
讲 , 它 在 某 些 方面 与 RWD 相同 ; 尤其 是 , 它 推进 了 单个 后 端 和 调用 单个 URL 的 观念 。 然而， 
从 更 深层 次 来 看 ， 多 设备 设计 与 RWD 不 同 ， 因 为 它 推进 了 不 同类 别 设备 的 不 同 视图 的 使 用 。 
视图 不 只 是 一 个 不 同 的 CSS 文件 那么 简单 ， 它 还 包括 不 同 的 标记 和 脚本 。 

多 设备 并 不 意味 着 你 要 为 每 种 设备 创建 一 个 不 同 的 UI; 而 且 它 不 意味 着 你 必须 负责 识别 
指定 设备 。 设 备 的 类 别 (智能 手机 、 平 板 电脑 、 大 屏 设 备 ) 差 不 多 与 RWD 中 的 断 点 相同 。 需 要 
进行 特性 检测 ， 但 在 服务 器 端 需要 一 些 特 设 工具 的 帮助 ， 比 如 设备 描述 库 (DDR)。 第 13 章 将 
进一步 介绍 这 方面 的 详细 内 容 。 


12.3 本章 小 结 
如 今 我 看 见 的 挑战 是 ， 我 们 要 如 何 找 到 一 种 将 移动 需求 与 昌 面 需求 结合 在 一 起 的 编程 邯 
想 i 


式 。 许 多 工作 的 重点 都 是 让 移动 端的 外 观 和 表现 与 蜗 面 端 相 似 。 我 不 清楚 这 是 否 是 达成 移动 
开发 的 正确 方式 。 
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打 个 比方 ， 让 我 们 假设 五 年 之 内 最 终 将 出 现 比 今天 更 多 的 强大 设备 ， 不 过 ， 移 动 设备 的 
基本 特征 并 不 会 发 生变 化 ， 它 将 仍然 比 笔记 本 电脑 小 且 性 能 弱 一 些 。 此 外 ， 就 商业 智慧 而 言 ， 
还 需要 处 理 长 尾 效应 的 问题 。 为 了 仅 文 持 高 端 设 备 ， 你 一 路 放 径 了 多 少 设备 呢 (可 能 将 其 留 给 
你 的 竞争 对 手 来 文 持 了 )? 

尽管 有 一 些 可 行 的 解决 方案 来 让 网 站 对 设备 友好 ， 但 主要 路 由 要 和 穿 过 为 不 同类 别 设备 的 
不 同 视图 提供 服务 的 架构 。 有 时 候 , 不 同 的 视图 通过 修改 CSS 文件 即 可 获得 ， 而 有 时 这 样 做 
还 不 够 ， 还 需要 不 同 的 标记 和 脚本 。 在 前 一 种 情况 中 ，RWD 和 客户 端 特性 检测 是 非常 好 的 
选择 。 人 否则 ， 就 需要 实现 服务 器 端 特 性 检测 ， 但 很 可 能 是 通过 使 用 智能 工具 及 非 手工 编写 代 
码 的 方式 来 进行 。 

在 这 一 章 ， 我 们 了 解 了 让 网 页 啊 应 不 同 浏 览 器 窗口 大 小 所 需 的 基本 知识 。 我 们 了 解 了 
HTMIS 这 一 响应 式 网 页 设计 基础 ， 以 及 Twitter Bootstrap 这 一 最 常用 的 创建 网 站 响应 式 体 验 
的 方法 。 此 外 ， 我 们 还 介绍 了 jQuery Mobile， 这 是 作为 移动 视图 的 一 个 示例 JavaScript 框架 
来 研究 的 。 
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未 来 属于 那些 今天 有 准备 的 人 。 
——Malcolm X 


我 预计 在 几 年 之 内 ， 那 些 不 能 很 好 地 被 主流 设备 所 使 用 的 网 站 将 面临 流量 显著 下 降 的 情 
况 。 我 有 意 使 用 了 “主流 设备 ”一 词 而 非 更 具体 的 像 平 板 电脑 或 智能 手机 这 样 的 名 词 ， 只 是 
鉴于 坏 卉 变化 非常 快 这 一 原因 : 没 人 能 明确 知道 几 年 内 会 出 现 哪些 设备 并 且 被 广泛 使 用 。 

不 过 ， 除 了 这 些 预测 之 外 ， 有 一 件 事 可 以 肯定 : 传统 手机 将 成 为 历史 。 它 们 会 变 得 与 恐 
龙 一 样 古 老 。 智 能 手机 的 定义 也 在 发 生变 化 ， 仪 仅 两 年 前 的 设备 就 和 最 新 一 代 版 本 的 性 能 和 
功能 显著 不 同上 了。 在 这 种 背景 下 ， 没 人 愿意 继续 进行 Web Forms 网 站 的 开发 ， 因 为 它 需 要 在 
设备 可 视 区 中 伸缩 ， 并 需要 用 户 来 放大 和 缩小 进而 阅读 与 单 击 链接 。 

如 何 创建 既 美 观 又 对 各 类 设备 高 度 可 用 的 网 站 呢 ? 

有 两 种 主流 想法 。 一 些 人 声称 应 该 一 直 专 注 于 设备 实际 公开 的 特性 。 这 称 为 特性 检测 ， 
这 一 方式 是 客户 端 所 固有 的 ， 并 且 要 使 用 层 登 样式 表 (CSS)/JavaScript 框架 来 决定 哪 一 个 层 更 
适合 于 请 求 页 面 。 另 外 ， 与 客户 应 特性 检测 相关 的 还 有 啊 应 式 网 页 设计 (RWD)， 一 种 利用 高 
级 CSS 功能 推送 流体 布局 以 便 将 内 容 雁 卢 有 顺序 加 载 到 可 用 空间 中 的 流行 设计 方法 。 

另 一 种 极端 的 情况 是 ， 一 些 人 更 愿意 在 服务 器 端 进行 处 理 。 他 们 喜欢 识别 出 设备 浏览 串 
发 送 的 用 户 代 理 字 符 串 并 静态 解析 出 已 检测 到 的 设备 的 一 些 功 能 。 然 后 ， 根 据 这 一 信息 ， 服 
务 器 端 解决 方案 就 能 够 知 能 地 提供 为 请 求 设备 量 身 定做 的 特 设 标记 。 

RWD 是 一 种 好 方式 ; 服务 器 病 也 是 一 种 好 方式 。 可 以 使 用 这 两 种 方式 来 完成 解决 方案 ; 
有 时 候 这 两 种 方式 混合 使 用 功能 更 加 强大 。 客 户 端 解决 方案 文 持 者 的 呼喊 声 肯 定 比 服务 器 端 
方式 文 持 者 的 大 。 这 已 经 吸引 了 越 来 越 多 的 人 ， 这 些 人 都 认可 这 一 观点 ， 即 对 比 在 不 可 维护 
的 混乱 怪异 的 用 户 代理 字符 串 中 进行 搜索 ， 特 性 检测 更 加 智能 和 快速 。 

总 的 来 说 ， 我 相信 RWD 的 优点 很 好 理解 ， 而 每 天 层出不穷 的 额外 框架 能 够 减少 RWD 
的 缺点 。 但 是 ， 我 也 相信 服务 器 端 解决 方案 的 优点 并 没有 被 真正 理解 ， 而 其 所 谓 的 缺点 不 过 
是 以 前 已 经 完全 过 去 的 软件 时 代 的 遗留 物 而 已 一 一 也 就 是 如 面 应 用 程序 与 浏览 器 之 争 的 时 代 。 
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在 这 一 章 中 ， 我 的 目标 是 呈现 服务 器 端 特 性 检测 方式 的 优 缺 点 ， 以 及 可 能 用 于 实现 这 一 
方式 的 额外 (并 且 非 免费 ) 工 具 。 


13.1 理解 ASP.NET MVC 中 的 显示 模式 


多 年 来 一 个 网 页 一 直 就 只 是 一 个 网 页 而 已 。 例 如 ， 如 果 一 个 用 户 请 求 defaultaspx， 他 就 
只 会 得 到 为 default.aspx 计算 的 内 容 ， 这 通常 与 请 求 浏览 器 的 能 力 无 天。 只 要 请 求 浏览 器 都 融 
入 朱 面 浏览 器 这 个 相同 类 别 ， 就 差不多 是 有 效 的 。 不 同 保 面 浏 览 器 版 本 之 间 在 呈现 上 可 能 会 
有 轻微 (而 恼人 人 的) 不同, 但 通过 在 HTML 中 使 用 一 点 jQuery 和 一 些 分 支 代 码 ， 我 们 已 经 围绕 
它 工作 多 年 了 。HTMLS5 的 到 来 添加 了 超越 标记 的 男 一 种 程度 的 差异 : 功能 。 值 得 庆幸 的 是 ， 
像 Modernizr 这 样 的 库 为 我 们 解 了 围 ， 这 些 库 有 助 于 一 些 功能 的 检测 以 及 提供 填充 层 的 基础 
架构 。 

然而 ， 文 持 多 种 设备 (并 且 不 只 是 果 面 浏览 右 ) 是 一 个 不 太一 样 的 问题 。 

多 种 设备 意味 着 请 求 浏览 器 可 以 是 明显 不 同 的 类 型 ， 因 为 它们 可 能 是 安装 在 智能 手机 、 
平板 电脑 、 智 能 电视 、 超 大 屏幕 设备 或 超 小 屏幕 设备 上 的 。 这 不 仅仅 是 让 相同 内 容 以 最 佳 可 
行 方式 适应 于 呈现 的 问题 ; 它 已 经 变 成 了 要 同时 让 内 容 和 行为 适应 于 完全 不 同 种 类 的 设备 以 
及 尽 可 能 实现 不 同 的 用 例 集 的 问题 。 

在 多 设备 方案 中 , 前面 提 到 的 default.aspx 页 面 会 分 解 成 许多 页 面 ,比如 default.smartphone. 
aspx、defaulttabletaspx 等 。 因 此 每 个 逻辑 页 面 可 能 会 根据 用 户 定义 规则 以 数 种 方式 显示 。 

显示 模式 组 成 的 ASPNET MVC 中 的 基础 染 构 ,能 够 有 效 地 处 理 单个 逻辑 页 面 的 多 种 视图 。 


13.1.1 ”分离 移动 视图 和 桌面 视图 


即便 我 坚定 地 认为 软件 中 不 会 存在 神奇 之 处 ， 但 还 是 不 得 不 说 ， 当 我 进行 以 下 步骤 以 及 
磁 到 ASPNET MVC 显示 模式 时 我 对 目 己 产生 了 严重 怀疑 。 


1. 移动 视图 的 内 症 文 持 


在 ASPNET MVC 中 ， 现 在 你 能 体验 到 一 种 有 意思 的 特性 ， 它 表面 上 运行 得 就 像 是 纯粹 
魔法 造成 的 结果 。 假 定 你 有 一 个 带 有 普通 简单 mdex 方法 的 HomeController 类 ， 就 像 如 下 所 
示 的 这 样 : 


Public class HomeController : Controller 
{ 
public ActionResult Index() 
{ 
Var model = ProcessRequestAndGetData (); 
return View (model).; 
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} 


第 2 章 “ASPNET MVC 视图 ”指出 ,位 于 项 目 中 Views/Home 文件 夹 内 的 名 为 index.cshtml 
的 文件 会 为 浏览 器 提供 HTML 以 便 呈 现 。 

现在 你 要 将 一 个 视图 文件 添加 到 Views/Home 文件 夹 并 将 其 命名 为 index.mobile.cshtml。 
可 以 给 予 该 文件 任何 你 喜欢 的 内 容 ; 只 要 确保 这 些 内 容 不 同 于 之 前 提 到 的 index.cshtml 即 可 。 
现在 ， 局 动 示例 站 点 并 用 第 规 和 更 面 浏览 器 (例如 ， 微 软 正 ) 和 移动 端 浏览 器 访问 它 。 可 以 使 用 
Windows Phone 模拟 器 或 Opera 模拟 器 。 令 人 惊讶 的 是 ， 你 得 到 的 home/index URL 的 视图 是 
在 index.mobile.cshtml 文件 中 编码 的 移动 视 鲜 。 


注意 : 

总 体 及 说 ， 进 行 功 能 测试 的 最 简单 且 无 需 太 多 繁琐 操作 的 方式 是 ， 在 正 中 按 下 F12 键 
以 显示 Developer Tools 窗口 。 在 该 窗口 ， 可 以 设置 一 个 匹配 移动 端 设 备 的 模拟 用 户 代 理 。 如 
果 不 确 定 要 输入 的 内 容 ， 这 里 有 匹配 运行 iPhone OS 6 的 iPhone 的 建议 : Mozilla/5.0 (iPhone: 
CPU iPhone OS 6 0 like Mac OS X) AppleWebK1t336.26 (KHTML, like Gecko). 


这 里 到 底 及 生 了 什么 ? 这 一 切 又 是 怎么 肥 生 的 呢 ? 
2. 移动 钢 图 的 于 认 配置 
让 我 们 逐步 对 ASPNET MVC 的 代码 进行 了 解 。 从 控制 器 方法 中 调用 视图 方法 时 ， 在 使 


用 CSHTML 视图 的 所 有 情形 中 ， 代 码 执 行 流 会 到 达 RazorViewEngine 类 。 在 ASPNET MVC 
中 ， 所 有 预定 义 的 视图 引擎 都 继承 自 同一 个 类 : VirtualPathProvider ViewEngne. 这 个 类 具有 
DisplayModeProvider 类 型 的 一 个 名 为 DisplayModeProvider 的 受 保护 属性 。 视 图 引擎 会 接收 
在 控制 器 级 别 设置 的 该 视图 的 名 称 : 该 名 称 可 以 是 “index”， 也 可 以 是 空 字符 串 ， 如 同 之 前 
的 示例 。 如 果 没 有 提供 视图 名 称 ， 视 图 引擎 会 假设 其 为 操作 的 名 称 。 

在 VirtualPathProviderViewEngine 基 关 中 ，WebFormsViewEngine 与 RazorViewEngine 都 
继承 自 该 基 类 , 在 视图 名 称 解 析 期 间 , 视图 引擎 会 查询 DisplayModeProvider 对 象 以 检查 是 人 否 
有 注册 的 显示 模式 能 够 应 用 到 请 求 视图 。 

每 个 显示 模式 都 是 以 一 个 后 级 字符 串 为 特征 的 ， 比 如 “mobile”。 如果 该 后 级 字符 串 与 已 
有 的 视图 名 称 匹 配 成 功 ， 则 原始 的 视图 名 称 惑 会 被 修改 以 指 回 表 示 匹 配 项 的 CSHTML 文件 。 
所 以 ， 打 个 比方 ， 可 能 会 发 生 “index” 变 成 “index.mobile” 的 情况 ， 如 果 项 目 中 存在 这 样 一 
个 视图 文件 的 话 。 

事实 证 明 ， 默 认 的 DisplayModeProvider 包含 两 个 预定 义 显 示 模 式 : 默认 与 移动 。 上 默认 显 
示 模 式 的 特征 是 衬 字 符 串 ;移动 显示 模式 的 特征 是 “mobile” 字 符 串 。 这 些 字 符 串 基本 上 表 
明了 附加 到 视图 名 称 的 后 级 。 这 也 就 是 index.mobile.cshtml 这 一 文件 名 称 的 来 历 了 。 
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13.1.2 ”选择 显示 模式 的 规则 


最 终 ， 显 示 模 式 提供 程序 指 的 是 一 个 内 部 组 件 ， 该 组 件 会 决定 视图 引擎 需要 呈现 的 实际 
视图 。 它 会 接收 在 控制 器 级 别 设置 的 视图 名 称 并 决定 是 否 用 指定 设备 视图 的 名 称 对 其 进行 普 
换 ， 如 果 该 指定 设备 视图 存在 的 话 。 有 一 个 问题 驱动 这 一 选择 的 逻辑 是 什么 ? 默认 情况 下 ， 
显示 模式 提供 程序 能 在 常规 桌面 视图 与 移动 视图 之 间 进 行 选择 。 但 是 ， 是 什么 来 确定 最 佳 的 
选择 呢 ? 


1. 对 显示 模式 命名 


在 ASPNET MVC 中 ， 显 示 模 式 是 由 名 称 为 DefaultDisplayMeode 的 类 实例 来 表示 的 。 这 
里 有 一 个 移动 显示 模式 的 定义 : 

Var mobileMode = new DefaultDisplayMode ("mobile"™") { 

ContextCondition = context => Context .GetOverriddenBrowser (). 
IsMobileDevice 

}; 

显示 模式 类 是 围绕 两 条 主要 信息 来 构建 的 ， 后 级 名 称 与 匹配 规则 。 在 之 前 的 代码 段 中 ， 
使 用 “mobile” 这 一 后 缀 创建 了 一 个 新 的 显示 模式 类 ， 并 问 ContextCondition 属性 分 配 了 一 条 
匹配 规则 。 

显示 模式 的 名 称 可 以 是 你 和 希望 你 的 站 点 文 持 的 能 唯一 标识 特定 视图 的 任意 字符 串 。 按 照 
惯例 ， 衬 字符 串 标 识 的 是 默认 视图 一 一 在 大 多 数 情况 下 是 捆 面 视图 ， 但 这 不 是 必须 的 。 默 认 
情况 下 , 移动 视图 能 识别 出 任何 其 他 的 请 求 浏览 器 ,通过 使 用 一 些 内 部 ASPNET 逻辑 可 以 将 
这 些 浏览 器 的 用 户 代理 字符 串 匹 配 到 一 种 移动 设备 。 

值得 注意 的 是 ， 移 动 显示 模式 管理 的 设备 属于 非 桌 面 设备 种 类 ， 包 括 老式 的 传统 手机 、 
最 新 的 智能 手机 、 平 板 电脑 、 小 型 平板 等 。 还 有 ， 移 动 显 示 模 式 并 不 会 区 分 操作 系统 。 对 此 ， 
我 们 完全 无 法 区 分 iPhone 设备 与 安 早 设备 ， 并 且 对 运行 安里 2.1 设备 的 处 理 方式 与 对 运行 安 
时 5.0 设备 的 处 理 方式 也 是 相同 的 。 

这 正 是 你 要 采用 茶 些 深层 目 定义 进行 干预 的 领域 ， 以 便 量 号 定 做 将 提供 给 各 种 设备 的 


标记 。 
2. 匹配 规则 


DefaultDisplayMode 类 具有 一 个 名 为 ContextCondition 的 属性 , 你 要 使 用 该 属性 来 检查 请 
求 的 上 下 文 并 将 其 匹配 到 一 个 受 文 持 的 显示 模式 。ContextCondition 属性 是 一 个 委托 ， 其 定义 
如 下 上 所 示 : 


FUuNCc<HttpContextBase, Boolean> 


dl 
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该 委托 的 目的 是 分 析 当 前 请 求 的 HITP 上 下 文 ,并 人 返回 一 个 布尔 值 以 回答 后 面 这 个 问题 : 
这 一 显示 模式 应 该 被 用 于 服务 当前 请 求 吗 ?如 何 得 到 该 布尔 值 响应 完全 取决 于 匹配 规则 的 
实现 . 

在 ASPNET MVC 中 ， 移 动 显示 模式 的 默认 实现 会 解析 随 请 求 而 来 的 用 户 代理 字符 串 ， 
并 试图 找 出 能 够 将 请 求 发 起 者 标记 为 移动 设备 的 已 知 关键 字 . 

注意 : 

归根 结 底 ， 事 实证 明 DefaultDisplayMode 类 的 名 称 存 在 一 些 误导 。 它 仅仅 是 定义 一 个 显 
示 模 式 的 类 而 已 。 在 我 看 来 ， 该 名 称 中 的 “Defaulf” 前 组 并 不 合适 。 


13.1.3 添加 自 定 义 显 示 模 式 


显示 模式 是 一 个 真正 的 强 有 力 的 特征 ， 但 你 只 有 在 清除 默认 配置 并 创建 你 自己 的 配置 后 
才能 充分 利用 它 。 首 先 ， 要 对 该 API 熟悉 ， 让 我 们 先 看 看 如 何 列 出 现 有 的 显示 模式 。 


1. 列 出 当前 的 显示 模式 


你 基本 上 不 需要 在 代码 中 执行 该 任务 ， 但 处 于 纯粹 的 兴趣 ， 我 还 是 建议 你 答 试 一 下 。 下 
面 是 读 取 和 显示 当前 可 用 模式 的 代码 : 


<U]> 
GT{ 
foreach (var d in DisplayModeProvider.Instance.Modes) 
{ 
<11>@ (String.IsNullorEmpty(d.DisplayModeId) ?"default™ : 
d.DisplayModeId)</11> 
} 
} 
</ul> 


你 要 使 用 Instance 静态 成 员 来 访问 DisplayModeProvider 类 的 单 例 实 例 并 逐一 查阅 Modes 
属性 。 图 13-1 显示 了 通过 下 开发 者 工具 栏 分 别 选 择 移动 和 加 面 用 户 代理 字符 串 的 示例 页 面 。 

现代 网 站 需要 比 移动 /桌面 两 种 选择 更 多 的 选项 来 用 于 选择 视图 。 最 有 可 能 的 情况 是 ， 你 
会 想 要 区 分 平板 电脑 、 智 能 手机 、 老 式 手 机 甚至 智能 电视 。 有 时 候 ， 一 个 简单 的 CSS 处 理 就 
足以 给 予 你 所 需 的 结果 。 这 就 是 RWD 能 够 完成 的 任务 。 然 而 还 有 一 些 时 候 ， 你 需要 通过 设 
备 提供 的 用 户 代 理 字 符 串 来 进行 设备 的 服务 器 端 检 测 。 
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Sample MOBILE page Sample DESKTOP page 


Mozilla/5.0 (Linwe U: Androtid 2.1; oc- Mozillay5.0 (compatible: MSIE 10.0: 
HTC Desire Build/ERE27) Windows NT 6.1; WOW64 Trident/6.0) 
AppleWebKit/525.10+ (KHTML, like Gecko) 

Version/3.0.4 Mobile Safary/523.12.2 Registered display modes 


Registered display modes »。 Mobile 
» default 

s Mobile 

» default 


图 13-1 在 指定 页面 的 果 面 与 移动 视图 之 则 进行 选择 的 ASPNET MVC 应 用 程序 示例 


2. 超越 默认 配置 


即使 普通 的 果 面 /移动 这 两 种 选择 能 够 满足 你 站 点 的 需求 , 你 也 应 该 注意 默认 移动 上 下 文 
条 件 背 后 的 逻辑 是 脆弱 的 这 一 事实 。 这 有 很 大 的 可 能 性 对 iPhone 与 黑 每 设备 起 作用 ， 但 甚至 
不 可 能 对 Windows Phone 与 安 早 设备 起 作用 ， 更 不 用 说 更 老 旧 与 更 简单 的 设备 了 。 之 前 你 所 
看 到 的 被 引用 的 MobileDevice 方法 确实 能 够 根据 它 在 .browser 文件 中 找到 的 信息 检测 出 用 
户 代理 字符 串 ，.browser 文件 是 随 着 ASPNET 一 起 安装 的 ， 如 图 13-2 所 示 。 

该 模型 显然 可 扩展 ， 并 且 任 何 时候 你 都 可 以 添加 更 多 的 信息 ; 但 是 对 .browser 文件 进行 
编写 并 不 简单 ， 而 且 测 试 、 检 枉 和 进一步 扩展 数据 库 的 担子 也 完全 压 在 你 的 肩 上 。 

如 果 将 图 13-2 的 内 容 与 你 在 你 的 互联 网 信息 服务 QIS) 计 算 机 上 具有 的 相同 文件 夹 中 的 内 
容 进行 对 比 ， 你 可 能 会 注意 到 一 些 不 同 之 处 。 尤 其 是 ， 图 中 的 文件 夹 包括 一 个 很 大 (18MB) 
的 浏览 左 文 件 ml -个 XML 文件 一 一 名 为 mobile.browser。 该 文件 来 自 于 一 个 古老 
的 、 已 停止 的 微软 项 目 ， 其 中 包含 了 截至 2013 年 夏天 出 现 的 合理 数量 的 设备 (参见 
mdbfcodeplex.com)。 上 所 有 后 来 出 现 的 设备 与 浏览 右 都 不 能 被 正确 检测 。 
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出 « v0.30319 b Config bk Browsers | | Search Browsers 


Urganize = Include in library = Share with = Burnm New folder 
克 Favorites Name Date modifred Type 
| 时 | blackberry.browser 3/28/2012 6599 AM BROWSER File 
Libraries (| chrome.browser 2B/2012 站 59 AM BROWSER File 
| 司 | Default,browser 3/28/20126G:59 AM BROWSER File 
+ Homegroup (| firefox.browser 328/20126:59 AM BROWSER File 
| 恒 | gateway.browser 3/28/20126G:59 AM BROWSER File 
-号 My Computer | 于 | genenc.browser 3/28/2012 6:39 AM BROWSER File 
鱼 Local Disk (C:} | ie,browser 3/28/20126:59 AM BROWSER File 
区 号 Local Disk (E:}) (3 iemobile.browser 3/28/20126:59 AM BROWSER File 
Ba Local Disk (F:) | 梧 | 有 home,browser 3/28/2012 6359AM BROWSER File 
| mobile.browser T2011 3:06 AM BROWSER File 18 .616 KB 
ei Network | 司 opera.browser 2B/20126:359 AM BROWSER File | 6 KB 
I 因 EXPOWARE | safan.browser 3/28/20126:59 AM BROWSER File 4 KB 
(a ucbrowser.browser 3/28/2012 659AM BROWSER File 2KB 


上 13 tems 


图 13-2 在 服务 器 计算 机 上 全 新 安装 的 ASPNET 所 提供 的 开 箱 即 用 的 浏览 器 配置 文件 列表 

奇怪 的 是 ，ASPNET MVC 基础 架构 并 没有 做 出 相应 的 修改 以 便 更 确切 地 处 理 这 方面 的 
内 容 。 归 根 结 底 ， 显 示 模 式 是 基础 架构 很 棒 的 一 部 分 ， 但 需要 你 承担 一 些 工作 来 配置 并 旦 需 
要 额外 的 工具 来 有 效 地 执行 视图 路 由 工作 。 更 为 重要 的 是 ， 要 让 ASPNET MVC 站 点 对 移动 
设备 友好 ， 你 需要 选取 一 个 外 部 框架 来 帮助 进行 设备 检测 ( 稍 后 我 将 继续 介绍 这 方面 的 内 容 )。 


3. 定义 和 目 定 义 显 示 模 式 


你 需要 使 用 显示 模式 来 赋予 你 站 点 同一 个 URL 的 多 个 视图 。 有 具体 来 说 ， 这 主要 是 指 为 
每 种 设备 或 你 关注 的 设备 种 类 定义 一 个 显示 模式 。 例 如 ， 可 以 创建 一 个 iphone 显示 模式 。 同 
样 ， 也 可 以 创建 一 个 平板 电脑 显示 模式 。 通 常 而 言 ， 显 示 模 式 对 于 创建 特定 于 移动 设备 的 视 
图 极其 有 用 ， 但 它们 仅仅 是 创建 特定 视图 的 工具 而 已 ， 这 些 特定 视图 会 在 应 用 到 HITP 上 下 
文 的 布尔 条 件 判定 值 为 tue 时 得 到 应 用 。 下 面 是 一 些 定义 了 几 个 上 自 定 义 显 示 模 式 并 蔡 换 了 点 
认 配 置 的 代码 : 

Var modeTablet = new DefaultDisplayMode ("tablet") 

{ 


ContextCondition = (c => IsTablet (c.Request)) 
}s 
var modeDesktop = new DefaultDisplayMode ("desktop") 
{ 


ContextCondition = {(c => return true) 
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ng 

displayModes.Add (modeTablet) ; 

displayModes.Add (modeDesktop); 

该 代码 要 从 Application_Start 处 运行 ， 它 会 丢弃 默认 显示 模式 并 定义 两 个 新 模式 : 平板 
电脑 和 蝎 面 。 首 先 添 加 的 是 平板 电脑 模式 并 且 它 会 被 衣 先 检 查 。 实 际 上 ， 找 出 合适 显示 模式 
的 内 部 逻辑 会 在 第 一 次 匹配 时 停止 。 如 果 HTTP 请 求 不 匹配 平板 电脑 ， 那 么 它 接 着 会 由 带 有 
为 果 面 设备 优化 的 视图 的 默认 项 进行 处 理 。 

请 注意 这 一 点 ， 因 为 桌面 模式 是 与 一 个 特定 的 非 空 字符 串 (desktop) 相 关 的 ， 所 以 每 个 视 
图 都 需要 具有 适当 的 后 缀 以 供 识别 。 换 句 话 说 ,index.cshtml 视图 文件 上 的 配置 并 不 会 被 使 用 。 
相反 ， 你 需要 使 用 名 为 index.desktop.cshtml 和 index.tablet.cshtml 的 视图 文件 。 


13.2 WURFL 数据 库 介 绍 


现在 关键 的 问题 就 变 成 了 后 面 这 个 : 你 如 何 才能 可 徘 地 确定 某 个 指定 请 求 是 否 来 自 于 一 
侣 平板 电脑 ? 

简单 的 答案 是 ， 这 一 切 都 与 咒 探 用 户 代 理 字 符 串 有 关 。 但 是 等 等 ， 噢 探 用 户 代 理 字 符 串 
不 正 是 将 开发 人 员 引 回 元 满 喜 悦 地 拥抱 RWD 以 及 客户 端 特征 探测 的 一 种 赴 梦 吗 ? 其 次 ， 举 
个 例子 ， 客 户 端 特征 探测 难道 不 足以 检测 设备 的 操作 系统 及 其 他 许多 特定 于 设备 的 功能 吗 ? 

服务 器 端 特 征 探测 不 仅仅 是 一 长 串 在 无 穷 无 尽 的 switch 语句 中 的 分 支 一 -每 个 switch 语 
句 对 应 一 种 可 能 和 已 知 的 代理 。 更 为 重要 的 是 ， 你 不 会 想 要 杀 目 对 用 户 代 理 嗅 探 进行 编码 。 
如 果 这 样 做 了 ， 将 很 可 能 无 法 采用 现 有 成 熟 的 方案 ， 使 你 目 己 陷 入 狐 狂 开 有 友和 维护 的 艰难 境 
地 。 要 让 服务 器 端 特 征 探测 不 成 为 负担 并 且 高 效 ， 你 需要 一 个 专业 的 用 户 代 理 嗅 探 工 具 : 设 
备 描述 存储 库 (DDR) 框 架 。DDR 是 像 预言 者 一 样 运行 的 组 件 ， 它 会 揭示 所 有 (已 知 的 ) 与 正 浏 
览 页 面 的 移动 端 浏览 器 有 关 的 实情 ， 以 便 你 能 够 明智 地 决定 作为 啊 应 来 提供 的 标记 。 

WURFL( 参 见 http://wurfl.sourceforge.net 人 是 当前 使 用 最 广泛 的 DDR， 但 它 肯 定 不 是 唯一 
的 一 个 。 像 Facebook 和 谷歌 这 样 的 大 企业 都 将 WUREFL 用 于 其 移动 站 点 。 而 且 它 对 于 开源 项 
目 还 是 免费 的 ， 并 且 还 有 部 分 免费 的 云 版 本 。 不 过 ， 对 于 商业 使 用 ， 你 很 可 能 需要 购买 授权 。 


更 多 信息 请 参阅 http://www.scientiamobile.com。 


注意 : 

“ 管 选 择 的 是 WURFL 还 是 其 他 产品 ， 比 如 51 degrees.mobi， 关 键 点 是 你 不 应 在 构建 自 
己 的 噢 探 用 户 代 理 字 符 串 的 解决 方 和 要 上 投入 精力 。 这 不 仅 是 因为 它 会 耗费 大 量 时 间 ， 还 因为 
鉴于 移动 端 浏览 器 的 大 量 种 类 ， 它 很 可 能 会 产生 一 个 脆弱 的 解决 方案 。 
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13.2.1 存储 库 的 结构 
WURFL DDR 包括 一 个 压缩 后 约 1.5 MB 大 小 的 XML 文件 ,在 扩展 后 也 不 会 超过 20 MB。 


可 以 从 http://wurfl.sourceforge.net 下 载 该 文件 最 新 的 快照 。 
注意 : 


下 载 WUREFL 数据 库 时 ， 人 必须 明确 同意 一 些 条 款 和 条 件 。 大体 来 说 ， 你 会 被 授权 使 用 未 
修改 的 WUREFL 文件 并 仅 通过 由 ScientiaMobile 提供 的 一 个 标准 WURFL API 来 使 用 该 文件 。 
对 于 ASPNET， 可 以 找到 一 个 NuGet 包 来 下 载 和 安奈 最 新 的 WURFL API 和 数据 库 。 


1. XML 总 体 架 构 
WUREFL 数据 文件 由 一 个 <device> 元 素 的 简单 列表 构成 。 这 里 是 该 数据 库 的 总 体 框架 : 
<devices> 


<device 1 "a0" USer dqent = ”fall back "> 
AE GE -> 
<capability name=". .." Value=". .." /> 


ye 
he 
ee 
id 特性 会 通过 名 称 唯一 标识 一 种 设备 。user agent 特性 表示 要 匹配 的 特定 用 户 代理 字 
符 串 。 
关键 的 特性 是 fall back， 通 过 名 称 将 其 引用 到 其 他 <device> 元 素 。fall back 特性 会 表明 
当前 设备 将 从 哪 种 设备 处 继承 缺失 的 性 能 。 换 句 话 说 ， 每 一 个 设备 节 都 仅 插 述 了 当前 设备 与 
其 父 设备 之 间 的 差异 。 所 有 设备 都 会 直接 或 间接 引用 一 个 通用 根 设备 ， 该 根 设 备 会 确保 所 有 
文 持 的 性 能 总 是 具有 一 个 默认 值 并 且 在 查询 期 间 不 会 抛 出 寞 第 。WURFL 文 持 多 个 通用 根 设 
备 ， 每 种 可 识别 的 设备 类 别 一 个 ， 这 些 可 识别 设备 类 别 包括 : 移动 电话 、 平 板 电脑 、 智 能 电 
视 以 及 未 来 可 能 的 更 多 设备 。 


2. 性 能 分 组 


每 种 设备 都 是 与 一 个 性 能 列表 关联 的 。 一 个 性 能 会 被 描述 成 名 称 / 值 对 ， 其 中 值 往往 被 认 
为 是 一 个 字符 串 。 这 意味 着 WURFL API 将 总 是 返回 普通 字符 串 类 型 的 性 能 值 ， 而 不 会 尝试 
将 该 值 匹配 成 特定 的 类 型 ， 比 如 布尔 型 或 整 型 。 

之 所 以 这 样 做 是 为 了 特别 对 待 API 的 扩展 性 以 及 性 能 ， 而 非 其 他 。 实 际 上 ， 有 不 少 性 能 
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会 从 值 的 枚 从 中 获取 值 。 例 如 ，pointine method 性 能 表明 了 链接 是 如 何在 设备 上 激活 的 。 可 
能 的 值 有 触 控 笔 、 手 酮 、 触 摸 屏 、 点 击 轮 、 或 空 字符 串 。 所 有 这 些 选项 都 能 够 时 无 问题 地 作 
为 Java 和 .NET 语言 中 的 枚 举 类 型 来 表示 。 不 过 在 这 种 情形 下 ， 为 添加 新 的 可 行 指针 方法 而 
对 数据 文件 所 做 的 任何 扩展 也 都 需要 对 API 进行 修改 ， 并 可 能 会 中 断 现 有 的 应 用 程序 。 

为 了 保持 可 管理 性 ， 就 要 对 性 能 进行 分 组 。 表 13-1 列 出 了 当前 可 识别 的 分 组 。 不 过 ， 分 
组 在 API 中 坚 无 作用 ， 从 这 个 意义 上 讲 ， 无 须 对 信息 分 组 以 检索 性 能 的 值 。 


分 组 


display 
flash lite 
html ui 


image format 


]2me 


markup 


mms 
object download 
pdf 

playback 
product info 
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表 13-1 WURFL 中 浏览 器 和 设备 性 能 的 分 组 
尽管 是 这 个 名 称 , 但 这 一 分 组 还 定义 了 超出 普通 Ajax 编程 的 性 能 . 它 不 仅 向 你 表明 Ajax 
是 否 受 支持 ， 还 向 你 表明 DOM 与 CSS 操作 是 否 被 允许 以 及 能 够 处 理 地 理 位 置信 息 
与 网 络 特性 相关 的 性 能 ， 比 如 支持 无 线 电 广播 、Wi-Fi、 虚 拟 专用 网 (VPN) 以 及 最 大 访问 
与 能 入 式 浏 砚 占 的 缓存 配置 相关 的 性 能 
与 压缩 式 HIML 标记 相关 的 性 能 
与 通过 安装 在 设备 上 的 额外 芯片 提供 的 可 用 特性 相关 的 性 能 , 比如 FM 收音 机 和 近 场 通 


信 (NFO) 装 置 


与 CSS 特性 相关 的 性 能 ， 比 如 图 片 拼 合 、 边 框 、 圆 角 以 及 倾斜 

与 屏幕 大 小 (以 像素 与 毫米 计 ) 和 方向 相关 的 性 能 

与 支持 一 些 DRM 标准 相关 的 布尔 值 性 能 

与 对 Flash 应 用 程序 类 型 和 版 本 内 置 支持 有 关 的 性 能 

与 用 HIML MIME 类 型 提供 的 内 容 相关 的 性 能 。 该 分 组 包括 与 视 口 、HTMILS 画布 、 内 
相 图 片 以 及 首选 文档 类 型 描述 (DTD) 有 关 的 属性 

与 一 些 图 片 格式 支持 相关 的 布尔 值 性 能 

告知 开发 人 员 哪 些 Java 特性 可 用 于 J2ME 运行 时 中 的 midlets 的 性 能 ， 这 些 特性 包括 定 
位 、 屏 幕 大 小 、 套 接 字 、 图 片 、 多 媒体 以 及 更 多 

与 各 种 受 支 持 的 标记 类 型 相关 的 布尔 值 性 能 ， 其 中 包括 XHTML、 无 线 标记 语言 (WML) 
与 MMS 相关 的 性 能 ， 比 如 图 片 支 持 、 视 频 以 及 最 大 帧 率 

与 可 下 载 对 象 相关 的 性 能 ， 比 如 视频 剪辑 、 图 片 、 墙 纸 、 屏 幕 保 护 以 及 来 电 铃声 

与 原生 支持 PDF 内 容 相 关 的 性 能 

与 受 支 持 的 视频 格式 和 从 网 站 下 载 的 内 容 解 码 器 相关 的 性 能 

与 设备 相关 的 性 能 ， 比 如 品牌 和 型 号 名 称 、 是 移动 设备 、 电 话 还 是 平板 电脑 、 操作 系 统 、 
键盘 以 及 浏览 器 


分 组 


TSS 

security 
sound format 
simarttv 


SInS 


storage 
streaming 


transcoding 


wap push 
wml u 
xhtml ul 


下 面 列 出 了 揭示 通用 设备 CSS 性 能 


设 第: 
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( 续 表 ) 
与 原生 支持 RSS 源 相 关 的 性 能 
与 HTTPS 支持 和 IMEI 可 见 性 相关 的 性 能 
与 各 种 不 同音 频 格 式 相 关 的 布尔 值 性 能 
与 智能 电视 相关 的 性 能 
与 SMS、EMS( 富 文本 SMS) 以 及 电话 铃声 相关 的 性 能 ， 包 括 像 诺基亚 和 松下 这 样 一 些 
供应 商 的 特性 
与 设备 可 以 管理 的 页 面 大 小 相关 的 性 能 
与 支持 的 视频 格式 和 来 自 网 站 内 容 流 的 编码 相关 的 性 能 
这 些 性 能 的 目标 是 识别 来 自 代 码 转 换 器 的 请 求 一 一 代码 转换 器 是 一 款 能 够 用 作 网 关 并 
隐藏 真实 设备 信息 的 软件 ,。 这些 性 能 是 提供 给 你 以 便 在 需要 以 特殊 方式 处 理 请 求 的 时 候 
使 用 的 
这 些 性 能 的 目标 是 探测 有 效 无 线 应 用 协议 (WAP) 的 特性 
与 WML 标记 相关 的 性 能 
与 XHTML 标记 相关 的 性 能 


一 段 代码 摘要 一 一 访 通 用 议 备 指 的 驶 是 WUREFL 根 


<group id="css"> 
<capability name="css gradient™" Value="none" /> 
<capability name="css border image" Value="none" /> 
<capability name="css rounded corners" Value="none" /> 
<capability name="css spriting" value="false" /> 
<capability name="css supports width as percentage" value="true" /> 


</group> 


作为 对 照 ， 以 下 示例 旺 示 了 一 种 通用 安里 放 备 的 相同 分 组 : 


<group 1id="css"> 
<capability name="css border image" value="webkit"/> 
<capability name="css rounded corners™" value="webkit"/> 
<capability name="css spriting" value="true"/> 
<capability name="css supports width as Percentage"” value="true"/> 


</group> 


如 你 所 见 ， 


一 些 属性 可 以 重 写 。 
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3. WURFL 补丁 文件 


WUREL 存储 库 带 有 两 个 或 多 个 文件 (任意 命名 的 ): 一 个 是 代表 存储 库 自 喘 的 XML 文件 
(通常 命名 为 wurfl.xml); 其 他 的 都 是 补丁 文件 ， 通 第 使 用 xxx patch.xml 这 种 模式 来 命名 。 补 
丁 文件 都 是 可 选 的 。 


注意 : 
WURFL API 是 基于 配置 模块 的 , 通过 它 可 以 指向 存储 库 和 可 选 的 补丁 文件 . 在 ASPNET 
中 ， 你 要 么 可 以 通过 连贯 接口 以 编程 方式 达成 该 任务 ， 要 么 通过 web.config 文件 中 的 自 定义 


使 用 补丁 文件 , 你 就 可 以 改变 默认 存储 库 内 的 一 些 性 能 而 无 须 物 理 调整 原始 文件 (而 且 物 
理 调整 原始 文件 将 损坏 授权 ， 即 使 你 是 在 合法 获取 的 副本 上 进行 的 )。 换 句 话 说 ， 补 丁 文件 提 
供 了 一 种 重 写 WURFL 数据 库 内 茶 些 内 容 的 方法 。 在 解析 WURFL 文件 时 如 条 肥 现 了 补丁 ， 
那么 补丁 内 容 就 会 被 导入 以 构建 一 个 修改 后 的 存储 库 版 本 。 这 里 有 一 段 补 丁 文件 的 摘要 ， 该 
补丁 文件 是 为 Firefox 10 添加 文 持 的 (以 防止 该 版 本 浏览 器 不 受 最 新 更 新 的 存储 库 文 持 ): 


<device user agent="Firefox" fall back="generic web browser" ld="firefox"> 
<group 1id="product info"> 
<capability name="brand name" value="firefox" /> 
</group> 
</device> 
<device user agent="Mozilla/5.0 (Windows NT 5.1; rv:10.0) Gecko/20100101 
Firefox/10.0" 
fall back—"firefox" 1d="firefox 10 07> 
<group 1id="product info"> 
<capability name="model] name" value="10.0"/> 
</group> 
</device> 


为 何 你 会 想 要 使 用 补丁 文件 呢 ? 

总 的 来 说 ， 使 用 补丁 文件 的 主要 原因 站 ， 出 于 你 目 己 的 理由 为 茶 些 性 能 分 配 不 同 的 值 。 
例如 ， 假 设 你 为 平板 电脑 设备 定制 了 一 个 网 站 。 接 着 ， 你 碰 到 了 一 种 特殊 设备 ， 其 屏幕 尺寸 
足够 大 ， 能 够 完全 容纳 你 设计 的 平板 电脑 的 用 户 界 面 。 不 过 遗憾 的 是 ，WURFL 仍然 会 将 该 
特殊 设备 认 作 与 平板 电脑 不 同 的 其 他 设备 。 然 后 你 就 要 创建 一 个 新 补丁 文件 (或 编辑 已 有 的 补 
丁 文件 ) 并 重 写 is_tablet 性 能 ， 以 便 支持 该 特殊 设备 的 用 户 代理 。 下 面 是 示例 代码 

<device user agent="your nice tablet device that WURFL doesn't consider a 

tablet™ 


fall back="generic mobile" id="mytablet"> 
<group 1id="product info"> 
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<capability name="1s tablet™" value="true" /> 
</group> 
</device> 


补丁 文件 起 作用 的 为 一 场景 是 当 你 需要 一 个 在 WUREL 中 不 受 原 生 文 持 的 性 能 时 ， 这 要 
么 是 因为 它 对 于 你 的 应 用 程序 来 说 太 过 特殊 ， 要 么 是 因为 之 前 根本 没 人 考虑 过 它 。 最 后 ， 当 
友 现 有 一 些 销 误 数据 存在 于 原始 WURFL 数据 库 中 时 ， 补 丁 文件 也 能 够 起 到 帮助 作用 。 关 于 
补丁 文件 的 更 多 信息 以 及 示例 ， 请 访问 http://wurfl.sourceforge.net/patchfile.php。 

13.2.2 ”基础 WURFL 性 能 

让 我 们 仔细 看 看 一 些 WUREL 性 能 ,确切 地 了 解 可 以 通过 WURFL 获得 的 对 被 送 达 内容 
的 控制 水 平 . 下 面 是 对 超过 600 个 可 用 性 能 的 一 个 小 范围 选择 。 可 以 在 http://wurfl.sourceforge. 
net/help_doc.php 找到 有 大 WURFL 功能 的 完整 文档 。 

1. 识别 当前 设备 

关于 请 求 设备 ， 你 需要 了 解 的 最 常见 类 型 的 信息 是 其 身份 。 表 13-2 列 出 了 一 些 非 常 有 用 
的 性 有 能， 这 些 性 能 摘 述 了 伏 用 来 执行 当前 请 求 的 设备 。 该 表 显 示 了 性 能 的 名 称 、 其 WUREFL 
分 组 、 其 手 述 以 及 其 可 能 的 值 。 


表 13-2 与 设备 相关 的 性 能 
全 清二 
1s Wireless devlce 设备 是 无 线 的 
1s tablet product mfo 设备 是 平板 电脑 


product info | 字符 串 


1s Smarttv 上 中/ 假 设备 十 智能 电视 
device os 当前 设备 的 名 称 和 版 本 (比如 Android 2.2) 


device os version 
resolution width 以 像 了 系 为 日 位 的 屏 右 宽 肛 和 局 尾 
resolution height 
以 像 系 为 单位 的 图 片 能 在 议 备 上 家 浏览 的 
最 大 禄 上 度 


can assien phone number | product nfo 设备 可 以 与 手机 号 但 关联 。 这 用 于 区 分 仅 
使 用 SIM 来 浏览 Web 的 设备 


pointing method product info | 手柄 、 触 控 笔 、 触 | 该 方法 用 于 选择 链接 。 注 意 空 字符 串 表示 
摸 屏 、 点 击 轮 、“”| 的 是 设备 上 的 四 向 导航 ， 它 具有 上 下 左右 
四 个 按钮 来 导航 链接 


max image width 
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( 续 表 ) 


brand name product info 品牌 (比如 HTC)、 型 号 名 称 (比如 HTC 


model name A8g181)、 以 及 设备 的 侣 销 名 称 (比如 HTC 
marketing name 淘 望 ) 


其 中 一 些 属性 可 以 使 你 非常 精确 地 对 设备 进行 分 类 。 例 如 ， 可 以 检查 传 入 的 请 求 是 否 辣 
日 承载 在 无 线 设 备 上 的 浏览 右 。is wireless_ device 为 任何 能 匹配 到 移动 设备 的 用 户 1 R 理 字符 
串 返 回 tue， 这 些 设备 包括 手机 、PDA、 平 板 电脑 (不 包括 笔记 本 电脑 和 AppleTV 这 样 的 智能 
电视 )。 如 果 要 做 的 只 是 检测 移动 设备 ， 那 么 此 属性 正 是 你 所 需要 的 。 要 进行 更 详尽 的 分 析 ， 
你 还 可 以 检查 会 在 iPad 上 返回 true 的 is tablet ， 以 及 在 手机 (可 以 具有 关联 的 电话 号 码 ) 上 返 
回 true 的 can assign phone number ， 但 在 iPod 上 就 不 行 。 另 一 个 类 似 的 性 能 是 
has_cellular radio( 在 bearer 组 中 ): 此 性 能 会 表明 设备 是 售 可 以 安 疹 SIM, 不 害 其 用 途 是 什么 。 
可 以 在 iPad 上 使 用 SIM 卡 ， 但 不 能 在 像 Pod Touch 这 样 的 设备 上 使 用 SIM 卡 。 

如 果 需 要 区 分 10S 和 Android 或 Windows Phone 设备 ， 可 以 使 用 device os 和 
device os_ version 性 能 。 如 果 需 要 知道 准确 的 设备 信息 (制造 商 和 产品 名 称 )， 则 可 以 使 用 
model name 和 brand name。 

己 知 的 实际 屏幕 大 小 是 由 resolution width 和 resolution height 人 返回 的 。 最 后 ， 有 关 触 摸 
性 能 的 信息 ， 当 值 等 于 touchscreen 时 ， 会 由 pointing method 功能 返回 。 


注意 : 

有 关 操 作 系 统 的 任何 信息 都 暗含 在 用 户 代 理 中 。 当 在 设备 上 安 靖 一 个 操作 系统 的 新 版 本 
时 ， 它 应 该 也 会 更 新 浏览 器 ， 且 浏览 器 应 当 在 发 送 的 us-er-agent 字符 串 中 反映 该 操作 系统 的 
版 本 。 然 而 ， 这 只 是 预期 的 工作 方式 。 例 如 ， 在 旧 设 备 上 遇 到 系统 是 Android 2.2 版 本 、 但 浏 
览 器 仍然 反映 的 是 2.1 版 本 的 情况 是 不 足 为 奇 的 。 


2. 提供 特定 于 浏览 器 的 内 容 


表 13-3 列 出 了 一 些 性 能 ， 可 以 帮助 你 微调 提供 给 浏览 器 的 标记 。WUREL 处 处 充满 了 能 
够 对 所 提供 标记 进行 微调 的 性 能 。 下 面 的 性 能 代表 了 你 需要 在 服务 器 上 使 用 不 同 标记 模板 以 
生成 视图 的 场景 。 
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表 13-3 ”所 供 特 设 内 容 的 性 能 
viewport supported 浏览 磺 文 持 <viewport> 元 标 合 


image inlining html ui 真 / 假 浏览 器 能 显示 通过 数据 统一 资源 标识 符 
(URD 结 构 骨 入 的 图 片 


full flash support tlash lite 浏 宽 右 完 全 文 持 Flash 


cookie support 只/ 假 浏览 器 文 持 cookies 
preferred_markup 想 要 提供 给 浏览 器 的 标记 类 型 
png ips gif, tift, geyscale 浏览 器 能 显示 指定 类 型 的 图 片 


一 些 移 动 浏览 器 会 假定 它们 能 够 呈现 每 一 个 页 面 ， 所 以 它们 会 把 页 面 缩小 为 实际 的 屏幕 
大 小 ， 让 用 户 以 比较 便利 的 方式 通过 缩放 来 浏览 页 面 的 某 一 部 分 。HITML <viewport> 元 特性 
的 引入 使 开发 人 员 能 够 指示 虚拟 屏 虹 一 视 口 一 该 有 的 乒 寸 。 但 是 ，<viewpor 纪 元 标 和 位 并非 
是 标准 的 ,在 发 出 之 前 检查 一 下 会 更 安全 。 viewport supported 性 能 与 其 名 称 表 示 的 意思 是 一 
样 的 。 
浏览 器 将 图 片 视 为 独立 的 资源 并 触发 一 个 额外 的 请 求 来 下 载 它们 (如 采 未 在 本 地 缓存 的 
话 )。 对 于 移动 设备 ，HTTP 请 求 的 执行 成 本 远 比 在 果 面 浏览 器 中 大 得 多 ， 因 此 任何 技术 都 是 
受到 欢迎 的 ， 只 要 它 能 减少 完成 页 面 所 需 的 HTTP 请 求 的 数量 。 常 用 的 技术 包括 在 HTML 页 
和 面 中 骸 入 小 的 图 厂 作 为 base64 编码 的 文本 。 这 种 技术 被 称 为 图 片 内 联 ， 在 一 些 老 的 设备 上 不 
党 文 持 ， 只 有 对 能 够 最 小 化 下 载 的 设备 闫 别 才 蝎 重 归 。 
有 了 image inlining 功能 ， 可 以 提前 知道 请 求 浏 览 嚣 是 合 能 够 正确 显示 以 这 种 方式 骨 入 
的 图 片 。 如 果 这 样 的 检 枉 失败 了， 可 能 会 过 到 的 最 严重 问题 是 ， 图 片 被 浏览 器 用 于 缺失 图 片 
的 特定 占 位 符 所 取代 。 图 片 内 联 是 不可 能 从 浏览 器 内 部 通过 菜 些 智能 的 JavaScript 代码 来 检 
但 的 功能 之 一 。 
在 移动 网 络 中 ， 只 有 两 种 类 型 的 标记 语言 是 明显 相似 的 : 
e XHTML MP 这 是 浏览 右 可 以 极 快 速 解 机 和 呈现 的 移动 优化 标记 格式 。 另 外 , 通过 千 
看 多 用 途 互 联网 邮件 扩展 (MIME) 的 类 型 ， 任 何 浏 贤 右 部 可 以 合理 地 识别 出 该 页 面 古 
一 个 移动 页 面 。 可 惜 ， 该 标记 语言 不 像 HIML 那么 强大 ， 对 DOM 操作 、CSS 和 
JavaScript 的 文 持 也 并 不 高 级 一 全 少 不 是 以 览 浏 览 器 的 方式 。 

e HTML/ 视 窗 ”这 就 是 普通 的 HIML 标记 外 加 <viewport> 元 标签 .HTML/ 视 窗 实际 上 是 
由 iPhone 和 Safari 为 移动 设备 引入 的 。 与 用 于 完整 网 页 的 MIME 类 型 相当 ， 苹 果 公 
司 添加 了 <viewport 元 标签 来 充当 浏览 堪 识 别 由 移动 端 所 展示 的 页 面 的 一 个 线索 。 

在 WURFL 中 ,preferred markup 性 能 会 指示 哪 种 类 型 的 标记 适合 指定 的 浏 讽 右 。 如 有 果 议 
性 能 返回 html wi oma xhtmlmp 1 0， 那 么 你 就 要 提供 XHTML MP 标记 ; 如 果 返 回 值 是 
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html web 4 0， 那 么 你 最 好 提供 普通 的 HIML 并 使 用 <viewpor 人 元 标签 将 页 面 标记 为 移动 。 
提前 知晓 页 面 是 用 于 移动 端的 有 助 于 浏览 器 安排 最 佳 的 呈现 ， 避 免 了 缩小 的 页 面 以 及 需 
要 放大 才能 进行 有 效 交 互 的 必要 。 


13.3 在 ASP.NET MVC 显示 模式 下 使 用 WURFL 


如 前 所 述 ， 通 过 一 个 NuGet 包 ，WURFL 库 即 可 用 于 ASPNET。NuGet 包 会 下 载 一 个 二 
进 制 格式 的 示例 WURFL 数据 库 文件 。 请 记 住 ， 你 通过 该 软件 包 获 得 的 WURFL 数据 库 文 件 可 
能 不 是 最 新 的 文件 .要 获取 最 新 的 WUREFL 数据 库 的 公共 块 ,请 访问 http://wurfl.sourceforge.net。 
13.3.1 配置 WURFL 框 溢 


使 用 WUREFL 需要 一 些 简 单 的 步骤 ， 比 如 获得 二 进 制 文 件 、 通 过 项 目 引 用 这 些 文 件 ， 以 
及 初始 化 WUREFL 运行 时 。 


1. 安装 NuGet 包 


将 WURFL 添加 到 ASPNET 项 目的 最 简单 方法 是 借助 NuGet。 该 软件 包 的 名 称 是 
WURFL OfEcial API( 参 见 图 13-3)。 另 外 ， 访 软件 包 在 App_Data 文件 夹 下 安 沪 WURFL 数 
据 库 (一 个 压缩 文件 )。 你 不 需要 解压 该 文件 ，APTI 在 解压 的 时 候 也 会 对 其 进行 处 理 。 


攻 习 -一 一 [9 一 | 
ed padiegs ee = 


Online 


bap The official WURFL API for .NET Created by: ScientiaMobile, Inc, 
wuxi The official ASP.NET APIfor WURFL WURFL is Id: WURFL official APT 
a data repository containing the descriptions... 


&ll 
nuget.org Version: 1.5.0.1 

Mhy Repository Last Published: 10/14,/2013 
Search Results Downloads: 5706 


| View License Terms 
i 计 
The official ASP.NET API for WURFL, WUREFL 
sadata repository containing the 
descriptions of thousands of mobile 


devices. You use the library to query 
browser and device capabilities from the 
User-agent string. 


Tags: Mobile Phone ASP.NET WURFL 
Browser DDR Device Detection Data 
D | 二 寺 
Each package is licensed to you by its 加 
owmner, Microsoft is not responsible No Dependencies 
for, nor does rt grant any licenses to, 


third-party packades. 


图 13-3 ”安装 WURFL APINuGet 包 
NuGet 包 还 会 复制 一 些 文档 和 一 个 内 省 工具 (本 质 上 是 一 个 HTTP 处 理 程序 )， 当 将 其 放 
置 在 线 上 时 ， 能 够 有 助 于 以 调试 为 目的 的 对 WUREFL 数据 库 的 远程 查询 。 可 以 将 它 从 项 目 中 
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安全 移 除 ， 因 为 它 在 API 的 常规 功能 中 不 发 挥 任何 作用 。NuGet 包 还 给 web.config 文件 带 来 
了 一 些 变 化 。 具 体 来 说 ，NuGet 包 添 加 了 以 下 新 的 节 : 
<configSections> 
<section name="wurfl" requilirePermission="false" 
type="WURFL.Aspnet .Extensions.Config.WURFLCoNfigurationSection, 
Wurfl.Aspnet .Extensions, Version=1.5 ...™ /> 
</configSections> 


它 还 提供 了 一 些 自身 要 用 到 的 内 容 。 


<wurfl mode="Accuracy"> 
<mainF1ile path="~/App Data/wurfl-latest.z1ip™ /> 
</wWwurfl> 
wurfl 节 不 是 严格 必需 的 ， 你 从 NuGet 获得 的 配置 也 只 代表 了 配置 WUREL 的 一 种 可 能 
方式 而 已 。wurfl 节 主 要 是 让 你 设置 WURFL 数据 库 的 位 置 ， 以 及 应 用 可 选 补 丁 文件 的 位 置 。 
可 以 使 用 ASPNET 根 运算 符 () 来 表示 虚拟 路 径 。 不 过 ， 也 可 以 通过 使 用 本 地 API 以 编程 方 
式 在 配置 以 外 设置 源 和 补丁 文件 。 


2. 引用 设备 数据 库 


可 以 通过 使 用 一 个 配置 对 象 以 两 种 方式 将 WURFL 库 指向 源 数据 库 。 如 果 想 要 通过 
web.config 文件 指定 数据 库 路 人 径 ， 可 以 使 用 ApplicattonConfigurer 对 象 。 请 将 下 面 的 行 添加 到 
Application Start: 


WURFLManagerBulilder.Build (new ApplicationConfigurer ()); 


ApplicationConfigurer 类 会 从 web.config 文件 读 取 路 径 信息 。 相 反 ,， 如 果 想 要 以 编程 方式 
指定 WURFL 数据 库 的 位 置 以 及 可 选 和 补丁 文件 的 位 置 ， 束 使 用 mmMemoryConfigurer 对 
Var configurer = new InMemoryConfigurer () 
.MainFile (wurflDataF1ile) 
.PatchFile (yourWurflPatchFilel) 
.PatchFile (yourWurflPatchFile2); 
如 果 需 要 ， 你 还 可 以 通过 实现 TWURFLConfigurer 接口 来 创建 自己 的 配置 类 。 该 接口 相 
当 人 简单 ， 只 依赖 一 个 方法 ， 如 下 所 示 : 
public interface IWURFLCoNfigurer 


{ 
Configuration Build(); 
} 
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Configuration 对 象 也 是 公共 WURFL API 的 一 部 分 。 欲 知 详情 ， 可 以 阅读 
http://wurfl.sourceforge.net/docs/dotnet 的 文档 或 下 载 其 源 代 公 。 


3. 初始 化 WURFL 运行 时 


WURFL 库 的 工作 机 制 是 加 载 全 局 内 存 中 的 数据 库 内 容 以 及 按照 调用 方 的 要 求 提供 啊 
应 。 所 有 返回 的 啊 应 都 会 被 无 限期 缓存 ， 因 此 不 会 在 后 续 的 请 求 中 重新 计算 ， 除 非 应 用 程序 
重新 局 动 。 数 据 库 的 初始 加 载 发 生 在 应 用 程序 局 动 时 ;， 如 果 在 某 一 点 你 替换 了 服务 器 上 的 
WURFL 数据 库 ， 则 还 需要 重启 应 用 程序 以 使 更 改 生效 。 

WURFL 库 的 接 入 点 是 WUREFL 管理 器 对 象 , 它 是 由 上 述 WURFLManagerBuilder 类 型 上 
的 Build 方法 返回 的 。 访 生成 器 主要 做 一 件 事 情 : 定位 WUREFL 数据 库 并 将 其 内 容 加 载 到 内 
存 数据 结构 。 因 为 WUREFL 数据 库 实 质 上 是 一 个 XML 文件 ， 因 此 加 载 的 过 程 包 括 读 取 整个 
文档 并 将 其 解析 成 合适 的 零碎 部 分 。 

最 终 包含 已 解析 的 WUREFL 数据 的 内 存 数据 结构 会 充当 WUREFL 管理 句 私 有 的 内 部 缓存 。 
这 个 数据 结构 会 占用 大 部 分 WURFL 所 需 的 运行 时 内 存 。 最 后 ， 当 你 持 有 了 WUREFL 管理 器 
的 一 个 实例 时 ， 你 就 持 有 了 实际 的 WURFL 数据 和 用 来 读 取 它 的 工具 。WURFL 数据 在 
ASPNET 应 用 程序 的 上 下 文中 应 该 和 被 视 为 全 局 的 。 

现在 ， 问 题 变 成 了 你 如 何 引 用 从 应 用 程序 任意 位 置 启 动 时 所 创建 的 WUREFL 管理 器 的 单 
实例 ? 在 内 部 ,WUREFL 管理 器 的 构建 类 似 于 一 个 单 例 。 由 生成 器 所 创建 (然后 返回 ) 的 WUREFL 
管理 器 类 的 实例 会 被 分 配给 名 为 Instance 的 生成 器 类 的 一 个 公共 静态 成 员 。 在 所 有 你 需要 进 
行 WURFL 得 询 的 位 置 ， 都 需要 引用 该 管理 匿 ， 如 下 所 示 : 


var deviceInfo = WURFLManagerBuilder.Instance.GetDeviceForRequest (userAgent); 


请 注意 ，WUREL 管理 器 绝 不 能 在 内 部 重 置 。 如 果 在 应 用 程序 启动 时 正确 地 对 其 进行 了 
初始 化 ， 那 么 管理 器 就 不 可 能 变 成 null， 当然 ， 除 非 你 的 代码 中 有 一 个 管理 器 变量 被 分 配 了 
一 个 潜在 的 null 引用 的 路 径 。 


13.3.2 ”检测 设备 性 能 
现在 让 我 们 看 看 处 理 用 户 代理 字符 串 的 必要 条 件 ， 并 尽 可 能 地 了 解 调用 设备 。 
1. 处 理 HTTP 请 求 


WURFL 管理 器 对 象 有 一 个 名 为 GetDeviceForRequest 的 方法 ， 它 是 你 用 来 了 解 调用 设备 
的 主要 工具 。 


Var deviceInfo = WIRFLManagerBuilder.Instance. GetDeviceForRequest (userAgent); 


GetDeviceForRequest 方法 具有 几 个 重 载 ， 可 以 在 用 户 代 理 字 符 串 中 传递 调用 ， 就 像 
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ASPNET HttpRequest 对象 甚或 特定 于 WUREFL 的 WURFLRequest 对 象 一 样 ,接受 WURFLRequest 
类 型 的 重 载 是 用 于 模拟 测试 的 最 简单 灵活 的 一 个 重 载 ， 因 为 你 还 可 以 用 它 来 列 出 HITP 标 头 
和 用 户 代 理 字 符 串 。 

GetDeviceForRequest 方法 会 返回 一 个 实现 公共 IDevice 接口 的 内 部 对 象 。 在 该 接口 上 的 
所 有 成 员 当 中 ， 最 重要 和 最 常用 的 是 GetCapability。 该 方法 会 将 性 能 的 名 称 作 为 一 个 字符 串 
接收 ， 并 将 用 于 标识 设备 的 值 作 为 字符 串 返 回 。 下 面 的 代码 显示 了 如 何 获知 当前 设备 的 操作 
系统 (如 果 有 的 话 ): 


Strlng os = deviceInfo.GetCapability("device os"); 


对 GetCapability 的 每 次 调用 首先 都 会 检查 内 部 缓存 ， 然 后 对 内 存 中 的 数据 库 进行 从 头 至 
尾 的 读 取 。 有 所 有 计算 结果 都 会 缓存 以 供 进一步 使 用 。 出 于 明显 的 性 能 原因 ，WUREFL 管理 器 
会 保留 其 自己 的 私有 缓存 。 可 以 测量 一 下 ，WUREL 库 的 启动 通常 需要 几 秒 钟 的 时 间 ( 只 会 在 
调用 Application Start 时 上 友 生 一 次 )， 而 每 个 请 求 的 提供 时 间 只 有 几 蜡 秒 ， 并 且 和 稼 是 突 如 其 
来 的 。WUREFL 内 部 缓存 使 用 了 最 近 极 少 使 用 的 (LeastRecently-Used，LRU) 算 法 ， 它 会 自动 
填充 可 能 已 经 淘汰 的 设备 信息 。 

由 于 这 个 原因 ， 可 以 反复 调用 GetCapability 以 读 取 多 个 属性 。 不 过 ， 你 还 有 一 个 
GetAllCapabilities 方法 可 用 ， 并 且 只 有 在 .NET API 的 1.5 版 本 中 你 才 可 以 依靠 API 筛选 器 来 
限制 出 于 性 能 原因 由 API 管理 的 能 力 。 


重要 提示 : 

WUREFL 功能 总 是 返回 字符 串 值 。 将 所 有 返回 的 字符 串 转 变 成 更 易于 管理 的 可 用 数据 类 
型 ， 比 如 整数 或 布尔 值 ， 这 是 开发 人 员 要 负责 处 理 的 任务 。 你 应 该 仔细 地 检查 文档 ， 以 确保 
在 转换 成 基本 .NET 类 型 的 过 程 中 你 没有 遗漏 某 些 可 能 的 响应 字符 串 。 


2. 虚拟 性 能 


在 ASPNET 网 站 中 使 用 WUREL 的 一 个 常见 场景 是 为 不 同类 别 设备 提供 不 同 的 标记 。 要 
实现 这 一 目标 ,你 要 能 够 根据 设备 的 用 户 代理 字符 串 快 速 地 对 其 归 类 , 并 确定 它 是 智能 手机 、 
平板 电脑 还 是 传统 手机 。WUREL 还 提供 了 一 些 用 于 这 一 目的 的 虚拟 性 能 。 

对 虚拟 性 能 的 处 理 方式 与 常规 性 能 相同 ; 它们 之 所 以 被 称 为 虚拟 是 因为 它们 不 具体 引用 
设备 的 单个 和 特定 特性 。 典 型 的 例子 是 名 为 is _smartphone 的 性 能 。 该 性 能 会 指出 用 户 代 理 是 
个 能 够 与 智能 手机 设备 相关 联 。 从 与 用 户 代 理 关 联 的 性 能 识别 智能 手机 的 算法 深 植 于 
WUREL 的 内 部 , 主要 是 检查 操作 系统 的 版 本 、 触摸 功能 和 屏幕 宽度 。 表 13-4 显示 了 WURFL 
虚拟 性 能 的 完整 列表 。 
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表 13-4 WURFL 虚拟 性 能 


虚拟 性 能 拍 ” 述 

is android 如 果 设 备 运 行 的 是 Android 的 任意 版 本 ， 则 返回 True 

is_i0s 如 来 设备 运行 的 是 10S 的 任意 版 本 ， 则 返回 True 

is windows phone 如 果 设 备 运 行 的 是 Windows Phone 6.5 或 更 高 版 本 ， 则 返回 Tme。 注 意 这 不 
包括 Windows Mobile 或 Windows CE 

1s app 如 果 请 求 来 日 本 地 应 用 程序 , 则 返回 True。 这 通 种 指 的 是 请 求 来 目 WebView 
组 件 或 本 地 应 用 程序 进行 REST API 调用 的 情况 

is_full desktop 如 果 请 求 设 备 有 具有 完整 的 果 面 体验 ， 则 返回 True 

is largescreen 如 果 请 求 设备 的 屏 和 右上 共有 局 分 辩 率 ( 冤 度 和 局 度 超过 480 像 系 )， 则 返回 True 

is Imobile 如 果 设 备 是 像 手 机 、 平 板 电脑 、 妹 体 播 放 右 、 便 携 式 诉 戏 机 等 等 这 样 的 移动 
设备 ， 则 返回 True 

is robot 如 末 请 求 来 目 机 秦 人 、 疏 网 般 或 其 他 一 些 上 自动 HTTP 客户 靖 ， 则 返回 True 

is smartphone 如 果 人 设备 古 智能 手机 ， 则 返回 True。 从 内 部 看 ， 访 匹配 规 会 检查 操作 系统 、 
屏幕 蜗 度 、 指 示 方 法 以 及 其 他 一 些 性 能 

1is touchscreen 如 果 主 要 的 指示 方法 是 触摸 屏 ， 则 返回 True 

1s_wml preferred 如 果 请 求 设备 应 该 由 WML 标记 提供 服务 ， 则 返回 True 

is xhtmlmp preferred 如 果 请 求 设 备 应 该 由 XHTML-MP 标记 提供 服务 ， 则 返回 True 

is html preferred 如 果 请 求 设 备 应 该 由 HTML 标记 提供 服务 ， 则 返回 True 

advertised device os 退回 请 求 设备 的 操作 系统 。 这 对 于 移动 设备 和 果 面 设备 都 有 效 ( 例 如 : 


advertised device os VerTslo 


卫 


advertised browser 


“Mac OSX”) 

返回 请 求 设 备 的 操作 系统 版 本 。 这 对 于 移动 设备 和 
“XP” 、“10.2.1 ) 

返回 请 求 设 备 的 浏览 器 名 称 。 这 对 于 移动 设备 和 昌 面 设备 都 有 效 (例如 

“Chrome”) 


“Windows”、 


更 面 设备 都 有 效 (例如 : 


“Internet Explorer ”、 


要 使 用 虚拟 性 能 ， 可 以 使 用 一 个 和 微 不 同 的 API， 如 下 所 示 : 


String response = deviceInfo.GetVirtualCapability("1is smartphone"); 


至 少 ， 可 以 通过 一 个 补丁 文件 将 任何 用 户 代 理 重 写 成 一 个 智能 
3. 精度 与 性 能 对 比 
WURFL 引擎 有 两 种 工作 模式 将 用 户 代理 与 


手机 。 


-组 性 能 进行 匹配 ， 精度 和 性 能 。 你 通常 要 
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通过 配置 器 来 设置 工作 模式 ,如果 从 web.config 文件 获取 配置 ,就 可 以 通过 wurfl 节点 的 mode 
特性 来 指定 工作 模式 ， 如 下 所 示 : 

<wurfl mode="Accuracy"> 

<mainFile path="~/App Data/wurfl-latest.zip" /> 

</wurfl> 

用 于 mode 特性 的 可 能 值 有 Accuracy 和 Performance。 或 者 ,可 以 使 用 mmMemoryConfigurer 
对 象 上 的 SetMatchMode， 以 编程 方式 配置 工作 模式 。 

WURFLManagerBuilder.Buildl 

new InMemoryConfigurer () 
.MainFilel(...) 
.SetMatchMode (MatchMode.Accuracy) ); 

这 两 种 工作 模式 的 区 别 是 什么 ”区别 只 在 于 桌面 用 户 代理 。 就 移动 设备 来 说 一 一 那些 
is_wireless_device 性 能 设置 为 true 的 移动 设备 一 -这 两 种 工作 模式 没什么 区 别 ， 其 整体 的 行 
为 并 无 差异 。 而 对 于 其 他 类 型 的 设备 来 说 ，Performance 模式 代表 了 一 种 快捷 方式 ， 能 更 快速 
地 提供 欠 精 确 的 啊 应 。Performance 模式 的 影响 是 ， 如 果 用 户 代 理 是 果 面 浏览 妖 ， 你 就 不 会 得 
到 用 于 特定 用 户 代 理 的 有 效 性 能 值 ， 只 会 得 到 与 一 般 果 面 浏 览 右 相关 的 描述 。 

换 句 话说 ，Performance 模式 只 有 在 你 需要 迅速 排除 (或 纳入 ) 果 面 浏览 器 而 不 去 区 分 比如 
说 Internet Explorer 或 Chrome 或 Opera 的 版 本 时 才 会 成 为 一 个 选项 。 对 于 移动 设备 来 说 ， 
Accuracy 或 Performance 通常 提供 一 样 的 服务 并 返回 最 精确 的 啊 应 。 

请 记 住 ， 可 以 全 局 指定 工作 模式 (如 前 所 述 )， 但 也 可 以 在 每 次 调用 的 基础 上 指定 ， 这 可 
以 通过 使 用 WUREFL 千 理 器 对 象 上 GetDeviceForRequest 方法 的 以 下 重 载 来 实现 : 


public IDevlce GetDeviceForRequest (WURFLRequest wurflRequest, MatchMode 
matchMode) 


13.3.3 ”使 用 基于 WURFL 的 显示 模式 


在 本 章 前 面 我 们 讨论 过 ，ASPNET MVC 显示 模式 是 路 由 控制 器 选取 特定 视图 的 理想 方 
式 。 一 般 来 说 ， 显 示 模 式 不 是 特定 于 设备 的 模式 ， 在 某 种 意义 上 ， 你 还 可 以 使 用 显示 模式 直 
接 切换 到 站 点 的 灰 度 版 本 ( 译 者 注 : 灰 度 版 本 指 的 是 正式 版 前 的 最 后 一 个 版 本 。) 或 者 优化 特 
定 的 浏览 右 ， 比 如 Windows 8。 

在 任何 情况 下 ， 使 用 显示 模式 ， 其 路 由 到 指定 视图 的 逻辑 总 是 取决 于 编码 嚣 的。 如 果 打 
算 构建 用 于 多 种 设备 的 单个 网 站 ， 只 需要 制定 多 个 视图 集 一 一 每 个 你 文 持 的 设备 类 别 一 个 视 
图 集 。 然 后 各 设备 类 别 便 有 了 自己 的 显示 模式 。WURFL 有 助 于 确保 请 求 设备 映射 到 适当 的 
显示 模式 。 这 意味 着 平板 电脑 将 获得 指定 页 面 的 平板 电脑 视图 (如 果 有 的 话 )， 而 智能 手机 也 
将 获得 目 己 的 视图 。 
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重要 所 示 : 

这 种 方法 如 何 确保 你 切实 创建 了 多 设备 站 点 呢 ? 在 你 有 了 特定 于 设备 的 首页 后 ， 基 本 就 
完成 了 。 从 特定 于 设备 的 首页 中 ， 可 以 指向 所 有 视图 通用 的 页 面 ， 也 可 以 指向 实现 某 种 设备 
特定 用 例 的 页 面 。 也 可 以 决定 使 用 一 个 特定 于 设备 的 控制 器 (比如 TabletXxxControllemD) 来 处 理 
特定 于 某 种 设备 类 别 的 用 例 ， 并 将 常规 操作 保持 在 你 可 能 要 使 用 的 所 有 XxxController 类 中 


1. 选择 显示 模式 


要 有 效 地 规划 多 设备 站 点 ， 不 管 你 打算 使 用 什么 样 的 实现 技术 和 模式 ， 第 一 步 往 往 是 对 
你 要 文 持 的 设备 类 别 有 一 个 清晰 的 概念 。 如 果 和 希望 只 依赖 CSS， 那 么 这 将 需要 定义 RWD 断 
点 ( 见 第 12 章 “ 让 网 站 对 移动 端 友好 ”)。 或 者 ， 如 果 期 望 设置 一 个 服务 器 端 引 擎 并 对 请 求 设 
备 提 供 特 设 标 记 ， 便 需要 定义 显示 模式 。 

在 global.asax 中 ,可 以 放置 一 个 对 某 些 DisplayConfig 类 的 调用 , 这 些 类 会 定义 和 注册 你 
网 站 文 持 的 所 有 显示 模式 。 


DisplayConfig.ReglsterDisplayModes (DL1sSp1ayModeProvlder .Instance .Modes) ; 
下 面 是 用 于 RegisterDisplayModes 方法 的 代位: 
public class DisplayConfig 
{ 
public static void RegisterDisplayModes (IList<IDisplayMode> displayModes) 


{ 
Var modeDesktop = new DefaultDisplayMode("") 
{ 
ContextCondition = (cc => C-Reduest.IsDesktop () ) 
j} 
Var modesmartphone = new DefaultDisplayMode ("Smartphone") 
{ 
ContextCondition = (c => C-Redquest.IsSmartphone () ) 
上 
Var modeTablet = new DefaultDisplayMode ("tablet") 
{ 
ContextCondition = (C => c.Request.IsTablet ()) 
}; 
var modeLegacy = new DefaultDisplayMode ("legacy") 
{ 
ContextCondition = (c => c.Request.IsLegacy()) 
}; 


displayModes.Clear (); 
displayModes .Add (modesmartphone); 
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displayModes .Add (modeTablet) ; 
displayModes .Add (modeLegacy); 
displayModes .Add (modeDesktop); 


} 

该 方法 首先 会 清除 所 有 的 默认 模式 ， 再 添加 四 个 模式 :智能 手机 、 平 板 电脑 、 桌 面 浏览 
器 和 传统 手机 .这 意味 着 用 来 访问 多 设备 站 点 的 任何 设备 都 将 映射 到 这 些 模式 中 对 应 的 那个 。 

在 前 面 的 代码 中 , IsLegacy、IsTablet 和 HTTP Request 对 象 上 的 其 他 方法 都 是 普通 的 NET 
扩展 方法 ， 它 们 会 接收 HTTP 上 下 文 并 针对 “该 请 求 是 来 自 指定 类 型 的 设备 吗 ? ”问题 返回 
一 个 布尔 值 答案 。 

2. 定义 匹配 规则 

除了 量 身 定做 指定 视图 的 内 容 外 ， 你 还 可 以 有 效 地 使 用 WUREL 性 能 来 确定 某 用 户 代 理 
是 否 属 于 某 特 定 类 型 的 设备 。 你 在 RegisterDisplayModes 方法 的 源 代码 中 所 看 到 的 扩展 方法 
通过 使 用 WURFL 性 能 实现 了 用 户 代 理 字符 串 的 匹配 规则 。 下 面 是 一 些 可 以 用 来 检测 智能 手 
机 的 代码 : 


public static Boolean IsSmartphone (this HttpRequestBase request) 


{ 
return IssmartPhoneInternal (request .UserAgent).; 
} 
private static Boolean IsSmartPhoneInternal (String userAgent) 
{ 
var device = WURFLManagerBuilder.Instance. 
GetDeviceForRequest (userAgent); 
return device.IsWireless() &é& Idevice.IsTablet() && 
device.IsTouch() && 
device.Width() > 240 && 
(device.HasOs ("android", new Version(?2, 1)) || 
device.HasOs ("iphone os", new Version(3, 2)) || 
device.HasOs ("windows phone os", new Version(7, 1)) || 
device.HasOs ("rim os", new Version(6, 0))); 
} 


IsTouch、Width、HasOs 和 上 和 面 代 码 中 的 其 他 方法 就 是 其 自 喘 在 WURFL IDevice 接口 上 
定义 的 扩展 方法 。 下 面 是 其 代码 : 


public static class DeviceExtensions 


{ 


public static Boolean IsWireless (this IDevice device) 


{ 
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return device.GetCapability("1is wireless device") .ToBool (); 


public static Boolean IsTablet (this IDevice device) 


{ 
return device.GetCapability ("1is tablet") .TOBool (); 


public static Boolean IsTouch (this IDevice device) 


{ 
return device.GetCapability ("pointing method") .Equals ("touchscreen"); 


public static Int32 Width (this IDevice device) 


{ 
return device.GetCapability("resolution width") .ToInt (); 


public static Boolean HasOs (this IDevice device, String os, Version version) 
{ 
// Check OS 
Var device0s = device.GetCapability ("device os"); 
1if (!'deviceOs.Equals (os, StringComparison. 
InvariantcultureIgnoreCase)) 
return false; 


// Check OS version 
Var deviceOsVersion = device.GetCapability("device os version"); 
1f (I'deviceOsVersion.Contains(™".")) 

deviceOsVersion = String.Format ("{0}.0", deviceOsVersion);) 


Version detectedVersion:; 
Var SUccess = Verslion.TryParse (deviceOsVersion, out detectedVersion); 


1f (lI!success) 
return false; 


return detectedVersion.CompareTo (version) >= 0; 


} 
同样 ，ToInt 和 ToBool 也 是 将 字符 串 解 析 成 数字 或 布尔 值 的 实用 扩展 方法 。 我 在 示例 中 
使 用 扩展 方法 主要 是 为 了 清晰 。 当 然 ， 个 用 这 些 扩 展 方 法 你 也 能 够 达成 同样 的 目的 。 
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3. 运行 中 的 多 设备 站 点 


显示 模式 的 实际 效果 是 ， 举 个 例子 ， 当 请 求 来 自 于 平板 电脑 时 ， 视 图 引擎 子 系统 就 会 路 
由 控制 器 以 选取 视图 的 平板 电脑 版 本 ， 如 果 有 的 话 。 鉴 于 之 前 的 配置 ， 所 选 的 视图 就 人 符合 名 
为 xxx.tablet.cshtml 的 Razor 文件 ， 如 网 13-4 所 示 。 


= > Ee http:A localhost1l6737 


Home (tablet) 


er NT FE 
有 一 笃 章 1 钾 量 
这 二 旺旺 本 本 二 到 


图 13-4 示例 多 设备 应 用 程序 的 表格 视图 
相同 的 页 面 在 智能 手机 和 传统 设备 上 看 起 来 是 不 一 样 的 ， 如 图 13-5 所 示 。 
你 要 做 的 就 是 使 用 多 个 Razor 文件 ， 为 每 个 你 希望 不 同 于 默认 视图 的 视图 分 配 一 个 。 默 
认 视 图 通常 (但 不 一 定 ) 是 桌面 视图 。 要 记 住 ， 显 示 模 式 是 基于 首 个 匹配 项 来 选择 的 ; 因此 你 
添加 显示 模式 的 顺序 决定 了 你 实际 会 拥有 的 视图 回 退 机 制 。 并 不 强制 要 求 为 应 用 程序 的 每 个 
视图 都 准备 一 个 智能 手机 文件 或 平板 电脑 文件 ， 例 如 ， 如 果 呆 面 视图 用 在 平板 电脑 上 不 产生 
任何 问题 ， 你 就 不 需要 有 xxx.tablet.cshtml 文件 。 


465 


第 川 部 分 “移动 客户 端 


Home (mobile) 


SCHEDULE 


SCORES StHEDULE 


VIDEQS FAGEBGOK TWITIER 


图 13-5 示例 多 设备 应 用 程序 的 智能 手机 和 传统 手机 视图 
13.3.4 WURFL 云 API 


在 刚才 讨论 的 示例 中 , 我 们 使 用 了 WUREL 的 内 部 部 署 版 本 , 这 需要 你 自己 管理 数据 库 ， 
确保 你 总 是 具有 最 新 的 存储 库 ， 并 且 在 出 现 问 题 时 可 以 为 数据 库 打 上 合适 的 补丁 。 不 过 ， 
WUREFL 还 提供 了 一 个 云 版 本 。 

不 足 为 奇 的 是 ，WUREFL 云 提 供 了 多 种 服务 方案 ， 其 苑 围 闻 兰 了 从 免费 但 受 限 的 方案 到 
包月 付 丑 的 几乎 不 受 限 制 的 访问 选择 。 可 以 在 http:Wwww.scientiamobile.comycloud 找到 许 细 
内 容 。 免 费 方 案 被 限制 为 仅 可 选择 两 个 性 能 ， 一 个 是 了 瑟 地 址 ， 另 一 个 是 域 ， 且 每 月 不 能 超过 
5000 次 检测 。 


1. 设置 API 


在 订购 其 云 服 务 之 后 ， 你 便 会 拥有 访问 管理 员 面 板 和 定义 感 兴趣 性 能 的 凭据 。 这 时 ， 可 
以 使 用 类 似 于 下 面 这 样 的 代码 : 


Var Config = new DefaultCloudCclientConfig 
{ 

ApiKey = "267026:2pXrnoY3JONhfzMBd7CEyRS2acuq0H6NU" 
}; 


Var manager = new CloudCclientManager (conf1g); 
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Var info = manager.GetDeviceInfo(httpContext, new[] { "is wireless device", 
"15 tablet™ ys 
GetDeviceInfo 方法 使 用 了 ASPNET 请 求 的 HTTP 上 下 文 和 具有 你 希望 接收 的 性 能 属性 
的 一 个 数组 。 出 于 性 能 的 原因 ,你 请 求 的 性 能 数量 也 可 以 比 允 许 你 请 求 的 全 部 性 能 数量 要 小 。 
返回 给 你 的 对 象 包含 一 个 名 为 Capabilities 的 字典 , 它 带 有 所 请 求 性 能 的 所 有 值 。 蝎 多 详 
青 ， 请 访问 http://www.scientiamobile.com/wurflCloud/gettingStarted。 


2. 云 APl 与 内 部 部 署 API 的 对 比 


面临 使 用 WURFL( 一 般 是 使 用 DDR) 时 ， 选 择 云端 比 选择 将 所 有 一 切 存 储 在 内 部 部 署 上 
更 好 吗 ? 你 需要 做 的 权衡 是 非常 容易 理解 的 。 

一 方面 ， 你 具有 单个 WUREL 请 求 的 民 好 性 能 ， 如 果 它 发 生 在 你 的 Web 服务 器 内 部 ， 明 
显 会 快 人 很 多 。 但 是 ， 为 一 方 甸 ， 你 需要 付出 购置 和 维护 成 本 。 内 部 部 草 许 可 的 成 本 和 分 期 摊 
销 的 速度 都 是 要 考虑 的 变量 。 另 一 个 变量 是 定期 更 新 WUREFL 数据 库 的 成 本 ， 包 括 下 载 每 周 
更 新 、 草 局 应 用 程序 和 检查 补丁 文件 的 成 本 。 最 后 ， 在 内 部 部 区 方案 中 ， 你 要 负责 处 理 任何 
可 能 退 济 到 的 与 WUREL 数据 库 有 关 的 扩展 性 问题 。 

在 云 方案 中 ， 你 只 要 为 可 能 所 需 的 最 小 服务 付费 即 可 。 但 是 ， 每 个 请 求 都 要 受到 服务 条 
玖 的 规范 ， 而 且 通 第 请 求 的 处 理 都 比较 慢 。 最 后 一 点 是 ， 你 无 法 控制 云端 的 数据 库 及 其 更 新 
周期 。 

按照 惯例 ， 最 佳 选择 往往 要 视 具体 情 况 而 定 。 


13.4 为 什么 应 该 考虑 服务 咒 冰 解决 万 案 


在 Web 开发 中 ， 可 以 实现 多 视角 一 一 即 打算 在 不 同 设 备 上 呈现 的 内 容 ， 这 些 设备 包括 平 
板 电脑 、 笔 记 本 电脑 和 智能 手机 一 一 可 以 用 后 面 两 种 方式 中 的 一 种 来 实现 。 可 以 使 用 单独 的 
一 组 页 面 和 多 个 辅助 资源 ， 比 如 CSS、 图 片 和 脚本 文件 ， 或 者 可 以 使 用 多 组 页 面 和 相关 的 次 
源 。 在 这 两 种 情形 中 ， 站 点 的 后 端 都 是 一 样 的 ， 业 务 逻 辑 也 几乎 是 相同 的 。 

但 你 想 要 的 是 “几乎 一 样 ” 还 是 “完全 一 样 ” 呢 ? 

这 是 可 能 影响 你 决策 过 程 的 关键 点 之 一 。 如 果 希 望 在 平板 电脑 、 智 能 手机 和 笔记 本 电脑 
上 的 体验 必须 相同 ,那么 RWD 和 客户 端 解决 方案 是 最 理想 的 办 法 。RWD 技术 是 创建 单个 网 
站 的 技术 ， 它 能 根据 显示 屏幕 的 大 小 自动 适应 和 调整 呈现 效果 ， 无 论 屏 幕 是 属于 智能 手机 或 
平板 电脑 的 ， 还 是 属于 桌面 计算 机 或 智能 电视 的 。 检 测 屏幕 大 小 和 应 用 正确 样式 表 的 工作 是 
由 Web 浏览 器 执行 的 。 

这 听 起 来 是 不 是 像 完美 的 解决 方案 ? 你 是 应 该 就 此 止步 还 是 再 多 考虑 一 下 呢 ? 让 我 们 
看 看 再 一 次 的 思量 还 会 带 来 什么 。 
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第 川 部 分 “移动 客户 端 


RWD 被 广 为 诉 病 的 是 ， 它 不 会 真正 地 区 分 设备 ， 而 是 只 区 分 屏幕 大 小 。 这 样 的 后 果 就 
是 ， 它 可 能 会 向 连接 到 很 慢 的 3 G 网 络 的 小 设备 发 送 很 多 的 内 容 。 换 句 话说, RWD 是 处 理 多 
个 屏幕 尺寸 的 有 效 方法 ， 但 不 一 定 是 处 理 带 有 不 同 特征 的 多 种 设备 的 有 效 方法 ， 这 些 特征 也 
包括 不 同 的 屏幕 尺寸 。RWD 中 你 很 难处 理 的 一 种 情况 是 ， 你 需要 为 通过 特定 设备 连接 的 用 
户 提供 不 同 的 功能 、 布 局 和 用 例 ， 但 要 如 何 才能 达成 目的 呢 ? 

简 而 言 之 ， 要 做 出 明智 决定 ， 必 须 回答 的 关键 问题 是 ， 你 是 否 想 要 提供 一 种 独特 的 、 特 
定 于 设备 的 体验 。 你 想 要 为 平板 电脑 、 智 能 手机 和 笔记 本 电脑 做 不 同 的 分 析 和 设计 吗 ? 一 个 
设计 对 你 来 说 足够 吗 ? 如 果 一 个 设计 就 能 满足 需求 ， 那 就 请 继续 使 用 RWD 并 使 用 实现 技巧 
来 减少 下 载 和 性 能 问题 。 如 果 一 个 设计 不 能 让 你 满意 ， 那 么 请 专注 于 用 户 代理 的 服务 器 端 
析 的 技术 和 产品 ， 以 识别 请 求 设备 的 类 别 。 

当 可 以 使 用 单个 设计 /项 目 来 适应 任何 设备 的 时 候 , 客户 端 解 决 方案 就 能 够 胜任 了 。 当 你 
希望 在 单个 网 站 的 上 下 文中 拥有 一 个 用 于 每 个 设备 类 别 的 特定 设计 /项 目 时 , 服务 器 解决 方案 
是 比较 合适 的 。 


13.5 本草 小 结 


并 没有 太 多 的 网 站 真 的 需要 求助 于 服务 咒 端 设备 检测 。 对 于 大 多 数 站 点 来 说 ， 一 个 基于 
RWD 原则 的 客户 端 解决 方案 就 已 经 足够 了 。 但 是 ， 这 并 不 意味 着 客户 端 解决 方案 总 是 优 于 
服务 器 端 解决 方案 。 

服务 器 端 解决 方案 本 质 上 比 单纯 基于 RWD 的 客户 端 解决 方案 要 更 具 灵 活性 。 


要 识别 请 求 设备 ， 搞 清楚 它 的 性 能 ， 然 后 提供 针对 性 的 标记 。 这 可 以 保证 一 个 800 像素 的 平 
板 电脑 将 会 接收 为 移动 用 户 量 身 定做 的 内 容 ， 而 通过 800 像素 浏览 器 窗口 连接 的 用 户 将 接收 
到 特定 于 昌 面 端的 内 容 。 使 用 客户 端 逻 辑 ， 你 不 能 确定 查看 页 面 的 浏览 器 是 托管 在 移动 设备 
上 还 是 托管 在 小 尺寸 的 浏览 器 窗口 上 。 

本 章 提供 了 一 个 服务 器 端 检测 的 有 力 观 点 ; 请 使 用 它 来 匹配 设备 类 别 (智能 手机 、 平 板 电 
脑 、 智 能 电视 、 笔 记 本 电脑 以 及 其 他 任何 你 能 想到 的 设备 ) 并 为 这 些 设备 提供 你 心目 中 的 站 点 。 
ASPNET MVC 的 显示 模式 特征 使 你 能 够 很 容易 地 创建 出 带 有 你 可 能 需要 的 多 种 外 观 ( 和 功能 
组 ) 的 单个 网 站 。 


